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Summary of Changes For Version 5.0 






The following changes have been made to this document. 

• The Job Cross-Reference Chart in Chapter 1. has been updated to include $trans, $trap, 

$DUMP, $MEMDISK, $COMPRES, and $E. 

• A new utility, $trans has been added for Version 5. It replaces the CS command of 
$COPYUTi. This utility makes it possible to transport EDX data sets and programs from one 
Series/ 1 to another. Refer to "$TRANS - Transmit Data Sets Across a Bisync Line" on 
pageUT-581 for this information. 

• The section "$DASDI - Format Disk or Diskette" on page UT-90 has also been updated to 
reflect the ability to use option to create both a stand alone dump and a STRAP diskette. 

• The STRAP section now contains information on how to dump storage to multiple diskettes 
for systems larger than 512K. This information is located in "$TRAP - Save Storage on 
Error Condition" on page UT-589. 

• Changes have been made to the prompt messages for the $dump utility. These changes are 
located in "$DUMP - Format and Display Saved Environment" on page UT-228. 

• LIST and PATCH commands of the $debug utility have been updated to illustrate their use 
with unmapped storage. A new close command and new prompts which appear when 
$debug is loaded have also been documented in "$DEBUG - Debugging Tool" on page 
UT-126. 

• Use of the $LOG utility is now required. Additional information regarding CIRCBUFF data is 
also contained in this version. Details on use of $log can be found in "$LOG - Log Errors 
into Data Set" on page UT-457. 
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Summary of Changes For Version 5.0 



Information about the 4975-01 ASCII printer is now included in the section entitled 
"$TERMUT1 - Change Terminal Parameters" on page UT-548. 
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About This Book 



This book is a reference book containing detailed descriptions of the Event Driven Executive 
operator commands, session manager, and system utilities. The commands and applicable 
syntax for each operator command and system utility are shown, along with usage examples. 






Audience 



This book is intended for anyone who has to operate the IBM Series/ 1 with the Event Driven 
Executive. Readers should have a basic understanding of computer terminology before using 
this book. 



Ho\A/This Book Is Organized 



The book is divided into the following 4 chapters. 

• Chapter 1, Introduction contains an overview of the contents of the book. 

• Chapter 2, Operator Commands contains a description and the syntax of the operator 
commands. 

• Chapter 3, Session Manager contains a description of the session manager facility. 

• Chapter 4, Utilities contains a description of each system utility used to operate your Event 
Driven Executive system. The utilities are presented in alphabetical order. 
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Aids in Using This Book 



This book contains the following aids to using the information it presents: 

• A chart of the main jobs that are done on the Series/ 1 with EDX. The chart is found under 
"Job Cross-Reference Chart" on page UT-2. It lists the operator command or system 
utility that is used for the job, the session manager option numbers to help you access the 
utiUty with the session manager, and the prefix of the guide in the EDX library that contains 
instructions for doing the job. 

• A table of contents that lists the major headings in this book. 

• An index of the topics covered in this book. 

• A glossary that defines terms and acronyms used in this book and in other EDX library 
publications. 

Illustrations in this book are enclosed in boxes. Many illustrations display output formats 
printed while using the Event Driven Executive. In those cases where the actual printer output 
exceeds the size of the box, the information is shown in a modified format. 

Examples of display screens are also enclosed in a box representing the outUne of a screen. A 
partial screen is indicated by the top or bottom of the screen. In examples where a response is 
required, the sample response is shown in red. 
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A Guide to the Library 



Refer to the Library Guide and Common Index for information on the design and structure of I J 

the Event Driven Executive Library, for a bibliography of related pubhcations, and for an index 
to the entire library. 

Refer to the Messages and Codes manual for information about return codes issued by each 
utility described in this reference. 



Contacting IBM about Problems 



You can inform IBM of any inaccuracies or problems you find when using this book by 
completing and mailing the Reader's Comment Form provided in the back of the book. 

If you have a problem with the Series/ 1 Event Driven Executive services, fill out an authorized 
program analysis report (APAR) form as described in the IBM Series /I Software Service Guide, 
GC34-0099. 
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Chapter 1. Introduction 






operating your IBM Series/ 1 Event Driven Executive (edx) system involves many different 
tasks, as follows: 

Installing the starter system 

Generating a tailored operating system 

Developing application programs 

Operating your system 

Determining hardware and/or software problems 

Customizing your system 

To perform these tasks, you use the operator commands and system utilities. 



Operator Commands 



Operator commands are instructions that represent a request for action by your edx system. 
When you enter an operator command, your edx system performs the action specified by the 
operator command. 

Chapter 2, "Operator Commands" contains a description and the syntax of each operator 
command, along with examples of its usage. 
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Session Manager 



The session manager is a collection of predefined screens called "menus" that you can use to 
access system utilities and application programs from a display station. 

Chapter 3, "Session Manager" contains an introduction to the session manager and a 
description of the facility. 



System Utilities 



The system utiUties are a set of programs that do everyday jobs on your Series/ 1 . The system 
utilities are independent programs that can be run concurrently with other application programs 
or utilities. 

Chapter 4, "Utilities" contains a description of each system utility. The utilities are presented in 
alphabetical order. 



Job Cross-Reference Chart 



JOB This column Usts specific jobs you may want to perform. 

OPERATOR COMMAND/UTILITY 

This column lists the name of the operator command or utility used to perform the 
job. 

SESSION MANAGER OPTION 

If a utility can be accessed through the session manager, the session manager option 
number is listed. 

GUIDE INFORMATION 

If instructions for doing a specific job are included in the Operation Guide, Event 
Driven Executive Language Programming Guide, Communications Guide, Problem 
Determination Guide, or Installation and System Generation Guide, the page prefix of 
the guide is Usted. 






The following chart directs you to the operator command or system utihty that will help you do a 
particular job. There are four columns within the chart. ^ 
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Job Cross-Reference Chart (continued) 

The prefix for each guide within the EDX library follows: 

PG Event Driven Language Programming Guide 

CO Communications Guide 

CU Customization Guide 

IS Installation and System Generation Guide 

OP Operations Guide 

PD Problem Determination Guide 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Allocate a data set 


$DISKUT1 
$TAPEUT1 


3.1 
3.10 


OP, IS 


Allocate an H -exchange data set 


$HXUT1 


3.11 


OP 


Allocate a mennber in a graphics data base 


$DICOMP 


5.2 


- 


Allocate a volume 


$INITDSK 


3.7 


OP, IS 


Allocate a volume under a fixed head 


$INITDSK 


3.7 


OP, IS 


Analyze GPIB errors 


$GPIBUT1 


4.9 


CO, PD 


Analyze hardware errors 


$DUMP 


9.1 


PD 


Analyze program checks 


$DUMP 


9.1 


PD 


Analyze tape surface for defects 


$TAPEUT1 


3.10 


— 


Browse a source data set 


$FSEDIT 


1 


— 


Cancel a program 


$C 


— 


OP 


Change hard-copy device 


$TERMUT1 


4.1 


OP 


Change print screen PF key 


$TERMUT1 


4.1 


OP 


Change spooj job attributes 


$SPLUT1 


4.7 


OP 


Change a tape label 


$TAPEUT1 


3.10 


OP 



Figure 1 (Part 1 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Change a terminal address 


$TERMUT1 


4.1 


OP 


Close job created by $DEBUG 


$DEBUG 


— 


— 


Compile an EDL program 


$EDXASM 


2.1 


PG, OP 


Compile and link edit an EDL program 


$EDXASM 
$EDXLINK 


2.2 


PG, OP 


Compile a program on a S/370 and execute it on a Series/1 


$UPDATEH 


2.10 


— 


Compress one volume or all volumes on a device 


$COMPRES 


3.4 


OP 


Controlling the job queue processor 


$JOBQUT 


10.1 


OP 


Control printer spooling 


$SPLUT1 


4.7 


OP 


Convert object modules to executing code 


$EDXLINK 
$UPDATE 


2.7 
2.9 


PG 


Copy all data sets 


$C0PYUT1 


3.3 


OP 


Copy a data set with automatic allocation 


$C0PYUT1 


3.3 


IS, OP 


Copy all data sets with the same prefix 


$C0PYUT1 


3.3 


OP 


Copy a basic exchange data set 


$COPY 


3.5 


OP 


Copy a disk/diskette data set to tape 


$TAPEUT1 


3.10 


OP 


Copy an H -exchange data set 


$HXUT1 


3.11 


OP 


Copy a tape data set to diskette 


$TAPEUT1 


3.10 


OP 


Copy a tape data set to tape 


$TAPEUT1 


3.10 


OP 


Copy a STRAP data set to two diskettes 


$COPY 


3.5 


OP 


Copy a volume or data set to an allocated volume or data set 


$COPY 


3.5 


OP 


Create an upper/lower case data set 


$FSEDIT 
$TERMUT2 


1 
4.2 


OP 


Create your own terminal keyboard characters 


$FONT 


4.5 


— 


Date and time, display 


$W 


— 


OP 


Date and time, set 


$T 


— 


OP 



Figure 1 (Part 2 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Delete job queue 


$JOBQUT 


10.1 


OP 


Delete a data set 


$DISKUT1 


3.1 


OP 


Delete all data sets with the same prefix 


$DISKUT1 


3.1 


OP 


Delete a volume 


SINITDSK 


3.7 


OP 


Determine address of a data set 


$DISKUT1 


3.1 


— 


Determine how many records a data set contains 


$DISKUT1 


3.1 


OP 


Determine terminal name, address, type and partition assignment 


$TERMUT1 


4.1 


OP 


Determine how much free space is on a volume 


$DISKUT1 


3.1 


OP 


Determine the hardware supported by supervisor 


$IOTEST 


9.3 


OP, IS 


Device, set offline 


$VARYOFF 


— 


OP 


Device, set online 


$VARYON 


— 


OP 


Display data/volume/storage contents in decimal, EBCDIC, or 
hexadecimal 


$DEBUG 
$DISKUT2 


— 3.2,9.2 


PD, OP 


Dump storage to a data set on error condition 


STRAP 


— 


PD, OP 


Dump unmapped storage 


STRAP 
$DUMP 


— 


PD, OP 


Estimate progress of compress 


SCOMPRES 


3.4 


OP 


Eject a page 


$E 


— 


OP 


End job queue processing 


$JOBQUT 


10.1 


PD 


Enter source statements 


$FSEDIT 


1 


PG, OP 


Erase contents of a data set 


$DISKUT2 


3.2,9.2 


— 


Erase display screen 


$B 


— 


OP 


Format and print BSC trace data sets 


$BSCTRCE 
$BSCUT1 


8.1 
8.2 


CO, PD 


Format and print error log information 


$DISKUT2 


3.2,9.2 


OP, PD 


Generate a supervisor 


$XPSLINK 


2.8 
2.13 


IS 



Figure 1 (Part 3 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Hold a job in the job queue processor 


$JOBQUT 


10.1 


OP 


Identify the program function keys on a 4978 and 4980 display station 


$PFMAP 


4.6 


— 


Increase the size of a data set 


$DISKUT1 
$COPY 


3.1 
3.5 


— 


Initialize a disk 


$DASDI 
$MEMDISK 


3.6 


IS, OP 


Initialize unmapped storage as a disk 


$MEMDISK 


— 


OP 


Initialize a diskette to EDX format 


$DASDI 


3.6 


OP 


Initialize a diskette to exchange format 


$DASDI 


3.6 


OP 


Initialize a diskette for a stand-alone/$TRAP dump 


$DASDI 


3.6 


OP 


Initialize a tape 


$TAPEUT1 


3.10 


OP 


Invoke your own operator command 


$U 


— 


OP, cu 


IPLa ">mote Series/ 1 


$S1S1UT1 


4.8 


CO 


Job queue processing controller 


$JOBQUT 


10.1 


OP 


Job queue job submission utility 


$SUBMIT 


10.2 


OP 


Link edit programs 


$EDXLINK 


2.7 


PG, OP 


List all data sets 


$DISKUT1 


3.1 


OP 


List data sets by type (program or data) 


$DISKUT1 


3.1 


OP 


List ail data sets with same prefix 


$DISKUT1 


3.1 


OP 


List a directory 


$INITDSK 


3.7 


OP 


List all volumes on all disk/diskette devices 


$DISKUT1 
$INITDSK 


3.1 


OP 


List all volumes on a particular device 


$INITDSK 


3.7 


OP 


List information about one data set 


$DISKUT1 


3.1 


OP 


List messages in source message data set 


$MSGUT1 


2.14 


OP 


Load and execute a program 


$L 


— 


OP 






Figure 1 (Part 4 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Load 4980 terminal 


$TERMUT2 


4.2 


OP 


Loading control image 


$TERMUT2 


4.2 


OP 


Loading control store 


$TERMUT2 


4.2 


OP 


Locate required data sets/overlays before program execution 


$PREFIND 


2.11 


— 


Message -source processing 


$MSGUT1 


2.14 


OP 


Modify a source data set 


$FSEDIT 


1 


OP,PG 


Partition assigned to terminal, change 


$CP 


— 


OP 


Prepare Version 1 and 2 data sets for use with Version 5 


$MI GRATE 

$MIGAID 

$MIGCOPY 


— 


IS 


Print a formatted $TRAP dump 


$DUMP 


9.1 


OP, PD 


Print a stand-alone dump 


$DUMP 


9.1 


OP, PD 


Programs, display all active 


$AALL 


— 


OP 


Programs, display all active in terminal's partition 


$A 


— 


OP 


Recognizing intermittent program errors 


STRAP 


— 


OP, PD 


Recording hardware errors 


$LOG 


— 


PD 


Recover a backed- up data set 


$MOVEVOL 


3.8 


OP 


Redefine terminal scrolling 


$TERMUT1 


4.1 


— 


Rename a disk/diskette volume 


$INITDSK 


3.7 


OP 


Rename a terminal 


$TERMUT1 


4.1 


OP 


Restart job queue processing 


$JOBQUT 


10.1 


OP 


Retrieve a data set from a host 


$EDIT1N 


— 


— 


Running batch job streams 


$JOBUTIL 
$SUBMIT 


7 
10.2 


OP 


Running multiple jobs 


$JOBUTIL 
$SUBMIT 


7 
10.2 


OP 



Figure 1 (Part 5 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Send a data set to a host 


$HCFUT1 


8.8 


CO 


Send a message to a terminal 


$TERMUT3 


4.3 


OP 


Setting PF keys 


$TERMUT2 


4.2 


OP 


Setting a terminal offline or online 


$TERMUT1 


4.1 


OP 


Sort a disk/diskette volume directory 


$DIRECT 


— 


— 


Spooling, change forms type 


$SALT 


— 


OP 


Spooling, change heading id 


$SALT 


— 


OP 


Spooling, change number of copies 


$SALT 


— 


OP 


Spooling, change printer 


$SALT 


— 


OP 


Spooling, delete a job 


$SDEL 


— 


OP 


Spooling, delete a set of jobs 


$SDG 


— 


OP 


Spooling, display status of jobs 


$S DISP 


— 


OP 


Spooling, display status of resources 


$S DISP 


— 


OP 


Spooling, display status of writers 


$S DISP 


— 


OP 


Spooling, hold jobs 


$S HOLD 


— 


OP 


Spooling, keep a job after printing 


$S KEEP 


— 


OP 


Spooling, release held jobs 


$SREL 


— 


OP 


Spooling, restart a writer 


$S WRES 


— 


OP 


Spooling, start 


$L $SPOOL 


— 


OP 


Spooling, start a writer 


$S WSTR 


— 


OP 


Spooling, stop 


$S STOP 


— 


OP 


Spooling, stop a writer 


$S WSTP 


— 


OP 


Storage, change contents (patch) 


$P 


— 


— 






Figure 1 (Part 6 of 7). Job Cross-reference Chart 
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Job Cross-Reference Chart (continued) 



'\ 



Job 


Operator 

Command/ 

Utility 


Session 

Manager 

Option 


Guide 
Information 


Storage, display contents 


$D 


— 


OP 


Storage map, display for all partitions 


$AALL 


— 


OP 


Storage nnap, display for terminal's partition 


$A 


— 


OP 


Submit a job into a host batch job stream 


$EDIT1N 


— 


— 


Suspend job queue processing 


$JOBQUT 


10.1 


OP 


Test the binary synchronous access method (BSCAM) 


$BSCUT2 


8.3 


CO, PD 


Test tape label type to ensure I/O commands executing correctly 


$TAPEUT1 


3.10 


— 


Test the operation of sensor I/O features 


$IOTEST 


9.3 


— 


Trace I/O activities on a BSC line 


$BSCTRCE 


8.1 


CO, PD 


Transport data sets across a bisync line 


$TRANS 


— 


OP 


Trap storage image on error condition 


STRAP 


— 


PD 


Trap to two diskettes 


STRAP 


— 


PD, OP 


Verify BSC hardware and software assignments 


$BSCUT2 


8.3 


CO, PD 


Verify Series/1 -Series/1 attachment performing correctly 


$S1S1UT1 


4.8 


CO, PD 


Write a tape label 


$TAPEUT1 


3.10 


OP 



^gjl^ 
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Chapter 2. Operator Commands 



The system operator commands provide system control functions from your terminal. They tell 
EDX to do things such as load a program and set the time and date. The 14 operator commands 
and their functions are: 

Command Function 

$A Displays partition sizes and addresses and the names, locations, and loading 

terminal names of all loaded programs. 

$B Blanks the display terminal screen. 

$C Cancels a running program. 

$CP Changes the partition assigned to a terminal. 

$D Displays the contents of storage. 

$E Ejects a page on the printer. 

$L Loads a program. 

$P Patches storage. 

$S Controls the spooling of program output. 

$T Enters the date and time. 

$U Invokes a user-written routine. 
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Operator Commands 



$VARYOFF Sets a device offline. 
$VARYON Sets a device online. 






$W 



Displays the date and time. 



This chapter shows you how to enter an operator command and describes the function and 
syntax of each command. Refer to the Operation Guide for procedures that use the operator 
commands. 



Entering Commands 



You can enter operator commands in one of two ways: prompt-reply or single-line format. With 
prompt-reply format you enter the command name and each parameter as the system asks for it. 
With single-line format you enter the command name and all the parameters on the same line. 
The following examples show you how to use the two formats. 



Prompt-Reply Format 



Press the attention key. After edx responds with the greater-than sign (>), type the operator 
command and press the enter key. edx responds with a prompt for the next parameter as each 
parameter is entered. 



> $L 



PGM(NAME, VOLUME, STORAGE): MYPROG.MYVOL ,256 
LOADING MYPROG ^P, 08: 30:^5, LP- 0000, PART=2 






,j^ 



Single-Line Format 



Press the attention key. After edx responds with the greater-than sign (>), type the operator 
command and all parameters in the order expected by edx, and press the enter key. 

You can enter all operator commands (except $T - set date and time) in the single-line format. 
I > $L MYPROG, MYVOL, 256 
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Entering Commands (continued) 
Operator Command Descriptions 



This section contains a description and the syntax of each operator command arranged in 
alphabetical order. 

Syntax Conventions 

The following conventions are used in the presentation of the operator command syntax: 

Uppercase If a parameter is shown in all uppercase letters, enter it exactly as shown. 

Lowercase If a parameter is shown is all lowercase letters, substitute a variable value. 

[ ] If two or more parameters are enclosed in brackets, chose one of them. The 

parameters within the brackets are separated by the or {\) character. 

I If parameters are separated by the or ( | ) character, choose one of them. 

$A - List Partitions and Active Programs 

Use the $A operator command to list the storage partitions defined for your EDX operating 
system. (A partition is a portion of storage in which programs run.) When you enter the $A 
command, the system provides the starting address, the name of the terminal from which the 
program was loaded, the size of each partition, and whether or not a partition is static or 
dynamic. It also tells you the names and address of each program active in each partition. 

You can use $A to list all partitions or only the one to which your terminal is assigned. 

Syntax: 



$A 


ALL 1 blank 


Required: 


none 


Default: 


starting address,size, and active programs of 




partition currently assigned to 
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Operator Command Descriptions (continued) 



Operamb Description 
ALL 



blank 



Displays the starting addresses and sizes of all partitions and the active programs in 
each partition. 

If you do not enter all, edx displays the starting addresses of the programs active 
in the partition where your terminal is running. 



y 



$B - Blank Display Screen 

Use the $B operator command to erase all information on your display terminal screen. 
Syntax: 



$B 

Required: 
Default: 



none 
none 



Operands Description 
None None 



^>.. 



^tiif^ 
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Operator Command Descriptions (continued) 

$C - Cancel Program 

Use the $C operator command to cancel a program running in the same partition as your 
terminal. If there is more than one program of the same name, edx asks (prompts) you for the 
load address of the program. The load address is the storage address where the program starts. 
You can find this address using the $A operator command. 

Notes: 

1 . $c should not be used as the normal means of stopping a program. 

2. $c should not be used to cancel some of the system utilities. If $c should not be used, the 
utility warns you on the first screen it displays. 

Syntax: 



$C 

Required: 
Default: 



program 

program 
none 






Operands Description 

program The name of the program to cancel. 



$CP - Change Display Termlnars Partition Assignment 

Some jobs require that the display terminal be running in the same partition as the object of the 
job, such as $C to cancel a program. Use the $CP operator command to change the partition 
number for the terminal you are using. 

Syntax: 



$CP 

Required: 
Default: 



n 
none 



Operands Description 

n The partition to which the terminal is to be assigned. 
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Operator Command Descriptions (continued) 



$D - Dump Storage 



Use the $D operator command to display, or dump, the contents of an area of storage on the 
screen of your display terminal. When you enter the $D command, edx displays the 
hexadecimal contents of the specified storage locations. 

Syntax: 



$D 



origin, address,count 



Required: origin 
Default: address defaults to 

count defaults to 1. 



>^ 



Operands Description 
origin 



address 
count 



The hexadecimal origin address. This can be any address, but if the address 
parameter is a displacement into a program, this value is the program load point. 

The hexadecimal displacement from origin at which the dump is to start. 

The decimal number of words to dump (maximum value of 16). 



_j^ 



$E - Eject Printer Page 



Use the $E operator command to advance (eject) one or more pages on the specified printer. 
Entering a number with $E advances the paper that number of pages. 

Syntax: 



$E 



n printername 



Required: none 

Default: ejects one page, $SYSPRTR 



Operands Description 

n The number of pages to eject. Defaults to printername. 
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Operator Command Descriptions (continued) 

$L - Load a Program or Utility 

Use the $L operator command to load a program into storage and start it running. 

Syntax: 



$L 


program,volume,storage data sets 


Required: 


program 


Default: 


volume defaults to IPL volume; storage 




defaults to the amount specified on the 




PROGRAM statement of the program to be 




loaded 



J 



Operands Description 

program The name of the program being loaded. This is the same as the name of the data 

set where the program is stored. 

volume The name of the volume containing the program data set. 

storage The total additional storage (in bytes) to be added to the end of the loaded 

program (overrides the storage= parameter specified in the program 
statement). The number of bytes that must be specified, if any, is determined by 
local procedures. If a '*' is specified, the loaded program will receive the 
maximum amount of contiguous free space available in that partition. 

data sets The data set and volume names of one to nine data sets being passed to the 

program. This parameter is required if DS=?? is coded on the program 
statement. The data sets must be specified in the order used by the program and 
entered in the format: name, volume name,... If data set names are required and 
you do not enter them as part of a single-Une command, edx prompts you for 
them. 
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Operator Command Descriptions (continued) 






$P - Patch Storage 



Use the $P operator command to change (patch) one or more words of storage. (Refer to the 
Problem Determination Guide for instructions on using $P.) 

Note: Patching of main storage is only valid for the current session. When the system is 
reinitialized (IPL'D) or the executing program is reloaded, the patched data reverts to its original 
value. 



Syntax: 



$P 



origin, address,count 



Required: origin 
Default: address defaults to 

count defaults to 1. 



Operands Description 
origin 



The hexadecimal origin address (program load point). Use the $A operator 
command to determine this address. 



address The hexadecimal address in the program where the patch starts. 

count The decimal number of words being patched. A maximum of 16 words can be 

patched. 






m ^ 



UT-18 SC34-0644 



o 



Operator Command Descriptions (continued) 

$8 - Control Spooled Program Output 

Use the $s operator command to control the operation of printer spooling from your display 
terminal. $s has several subcommands that do these control functions. The syntax for these 
subcommands is described on the following pages under: 



"$S - List Subcommands" on page UT-20 

"$S ALT - Alter Spool Job Printing" on page UT-20 

"$S BALL - Delete All Spool Jobs" on page UT-21 

"$S DE - Delete a Spool Job" on page UT-22 

"$S DG - Delete Generic Spool Jobs" on page UT-22 

"$S DISP - Display Spool Status Information" on page UT-23 

"$S HOLD - Hold Spool Job(s)" on page UT-23 

"$S KEEP - Keep or Release a Spool Job" on page UT-24 

"$S REL - Release Spool Job(s)" on page UT-24 

"$S STOP - Stop Spooling Facility" on page UT-25 

"$S WRES - Restart a Spool Writer" on page UT-25 

"$S WSTP - Stop a Spool Writer" on page UT-26 

"$S WSTR - Start a Spool Writer" on page UT-27 
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Operator Command Descriptions (continued) 

$8 - List Subcommands 

Use the $s command to obtain a list of the $s subcommands. 
Syntax: 



$S 

Required: none 
Default: none 



$S ALT - Alter Spool Job Printing 



Use the $s alt command to change the parameters that control the way a spool job is printed. 
You can: 



Change the number of copies printed. 

Change the forms code for the job. 

Change the job name used on the spool job separator page. 

Redirect one spool job to a different printer. 

Redirect all spool jobs from one printer to another printer. 

Specify that forms alignment be verified before a job is printed. 



Syntax: 






$S ALT id [ COPY n I FORM code I NAME heading I WRIT name I ALIGN Y/N] 

or 
$S ALT WRIT cwriternwriter 

Required: id and either COPY FORM NAME WRIT or ALIGN 

or 

WRIT cwriter nwriter 
Default: none 
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Operator Command Descriptions (continued) 



■> 



operands Description 

id The one-to-three-digit identification assigned to a spool job by the spool facility. 

This identification is included on the spool status report generated by the $s DISP all 
operator command. 

COPY n - The number of copies to be printed (must be from 1 to 127). 

FORM code - The four-character code identifying the forms required to print the spool job. 

NAME heading - A one-to-eight-character heading printed on the spool job separator page. 
It defaults to the name of the program which created the spool job. 

WRIT The name of the spoolable printer or display terminal. The "writ name" form of 

this parameter is used to assign a printer or display terminal to a particular spool job. 
The "WRIT cwriter nwriter" form is used to redirect spool jobs from one spool 
device to another. 

name The name of the spool device for this spool job. 

cwriter The name of the current spool device whose spool jobs are to be 

redirected. 

nwriter The name of the new spool device. 

ALIGN Y/N - Specifies whether forms alignment is to be verified before the spool job is 
printed (Y=yes, N=no). Alignment is verified for the next complete copy of the 
job. Alignment is not verified for a job that is printing when this command is 
entered or for a job that has been stopped with the $S WSTP command. 

$8 DALL - Delete All Spool Jobs 

Use $s DALL to delete all ready or printing spool jobs. 

Syntax: 



$S DALL 

Required: None 
Default: None 



Operand Description 
None None 
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Operator Command Descriptions (continued) 

$S DE - Delete a Spool Job 

Use $S DE to delete one spool job that is either ready or printing. 
Syntax: 



/4 F\ 



$S DE id 

Required: id 
Default: None 



Operands Description 



id 



The one-to-three-digit identification assigned to a spool job by the spool facility. 
This identification is included on the spool status report generated by the $S DISP 
ALL operator command. 



$S DG - Delete Generic Spool Jobs 



Use the $s DG command to delete all ready or printing spool jobs that have a name starting with 
a specified prefix. 

Syntax: 






$S DG string 

Required: string 
Default: None 



Operands Description 

string A one-to-eight-character prefix that specifies the spool jobs to be deleted. All 

spool jobs with this prefix are deleted. 
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Operator Command Descriptions (continued) 

$S DISP - Display Spool Status Information 

Use $s DISP to display information about spool jobs, spool resources, and spool writers. 

Syntax: 



$S DISP id I ALL I STAT 

Required: None 
Default: ALL 



.^y 



Operands Description 

id The internal one-to-three-character identification assigned to a spool job by the 

spool facility. This identification is obtained by using the $s DISP ALL command. 

ALL Displays the status of all spool jobs, all spool writers, and all spool resources. 

STAT Displays the status of the spool resources. 

$S HOLD - Hold Spool Job(s) 

Use the $S hold command to hold a specific spool job, or all spool jobs, from being printed. 
Only active and ready spool jobs can be held. 

Syntax: 



$S HOLD id I ALL 

Required: None 
Default: ALL 



Operands Description 



id 



ALL 



The one-to-three-character identification assigned to a spool job by the spool 
facility. This identification is included on the spool status report generated by the 
$s DISP all operator command. 

Holds all active and ready spool jobs and all future spool jobs. 
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Operator Command Descriptions (continued) 

$S KEEP - Keep or Release a Spool Job 

Use $s KEEP to keep a specific spool job from being deleted or to delete a job that has been 
kept. When a kept job is released, $SPOOL prints one additional copy before deleting the job. 

Syntax: 



$S KEEP 



id YiN 



Required: id and either Y or N 
Default: None 



Operands Description 



id 



The one-to-three-character identification assigned to a spool job by the spool 
facility. This identification is included on the spool status report generated by the 
$s DISP ALL operator command. 



N 



Keeps the spool job available after it is printed. The spool job is both held and 
kept after printing, with the number of copies set to one. Thus, when released by 
using the $S REL command, it is printed (even if printed once already). 

Deletes the spool job from the system after it is printed. When released by use of 
this operand, the number of copies of the spool job to be printed is set to one, even 
if more than one copy was requested before the job was kept. 



^^.:J 



$S REL - Release Spool Job(s) 



Use $s REL to release one, or all, held jobs for printing. A released job resumes its place in the 
ready queue; that is, its print order is still determined by the order in which it originally became 
ready. 

Syntax: 



$S REL id I ALL 

Required: None 
Default: ALL 



o 
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Operator Command Descriptions (continued) 



Operands Description 
id 



ALL 



The one-to-three-character identification assigned to a spool job by the spool 
facility. This identification is included on the spool status report generated by the 
$S DISP ALL operator command. 

Releases all currently held spool jobs. This resets the effect of the $s hold all 
command. 



$8 STOP - Stop Spooling Facility 



Use $s STOP to stop the spooling f aciUty. Spooling stops when any jobs in active or printing 
status finish. 

Syntax: 



$S STOP 

Required: None 
Default: None 



g^\ 



Operands Description 
None None 



$S WRES - Restart a Spool Writer 

Use $s WRES to restart a temporarily stopped spool writer. You can restart a writer: 

• at the beginning of the interrupted job 

• at the line following the last Une printed 

• at a specified number of lines or pages before or after the last Une printed 

Syntax: 



$S WRES 


name [IMM 1 JOBi B nnn L/PlFnnn L/P] code 


Required: 


name 




nnn and L or P if B or F specified 


Default: 


IMM 




code defaults to blanks 
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Operator Command Descriptions (continued) 



Operands Description 

name The name of the writer which is to be restarted. 

Resume printing at the next line of the interrupted spool job. 

Resume printing at the start of the interrupted spool job. 



IMM 

JOB 

B 



Resume printing nnn lines (L) or pages (P) before the hne where the job was 
stopped. 

F Resume printing nnn lines (L) or pages (P) after the line where the job was 

stopped. 

nnn The number of lines or pages backward (B) or forward (F) from the point of 

interruption. Specify this parameter if you specified B or F. 

If the writer scrolls to the start of the spool job, the complete job is printed. If the 
writer scrolls to the end of the spool job, the job is not printed. 

L Specifies that nnn is in lines. 

P Specifies that nnn is in pages. 

code The four-character forms code for the forms to be used for jobs printed by this 

writer. A new forms code specification takes effect when the writer processes the 
next job or the next copy of the current job. Defaults to blanks. 

$8 WSTP - Stop a Spool Writer 

Use $S WSTP to stop a spool writer. You can stop a spool writer: 

• immediately at the start of the next line of the spool job or at the end of the current job 

• temporarily, to be restarted with the $s WRES command, or permanently. A spool job that is 
permanently stopped is restarted with the $s wstr command. 

Syntax: 



$S WSTP name [IMM I JOB] [TERM I NOTERM] 

Required: name 

Default: IMM NOTERM 



m, w 
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Operator Command Descriptions (continued) 

Operands Description 

name The name of the writer which is being stopped. 

IMM Stop printing at the next line of the spool job. 

JOB Stop printing at the end of the current job. 

TERM Stop permanently. (The dedicated printer is released and writer task is ended.) 

Note: A permanently stopped writer task can only be restarted by the $s WSTR 
command. 

NOTERM Stop temporarily. The writer can be restarted by the $S WRES command. (The 
writer maintains control of the printer device.) 

$8 WSTR - Start a Spool Writer 

Use $s WSTR to start a spool writer and specify a forms code. 
Syntax: 



$S WSTR name code 

Required: name 

Default: code - defaults to blanks 



Operands Description 

name The name of the printer for which the writer is to be started. This is also the name 

of the writer. 

code The four-character forms code for the printer forms used with the jobs printed by 

this writer. Defaults to blanks. 



$T - Set Date and Time 

Use the $T operator command to set the date and time in the EDX operating system. 

You can only enter $T from a display terminal named $SYSLOG or $sysloga (the system logging 
display terminal or its alternate). If you enter it from a terminal with another name, the system 
displays the date and time as if you had entered a $w command. 

Note: $T must be entered in prompt-reply format. 
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Operator Command Descriptions (continued) 



Syntax: 






$T 

Required: 
Default: 


date,time 

date,time 

date defaults to 00/00/00 

time defaults to 00:00:00 



Operands Description 

date The current date. Can be entered as mm/JJ/jy^, mm.<5fc/.>{y., or mm ddyy. 

time The current time. Can be entered as hh:mm:ss, hh.mm, or hh mm. 



$U - Invoke Your Own Operator Command 



Use the $u operator command to enter an operator command function that is unique to your 
system. Refer to Customization Guide for information on how to write a program for the $U 
operator command. 

If $u is entered and your system does not have a program to support it, edx displays the 
message "function not defined." 



J 



$VARY0FF - Set Device Offline 



Use the $VARYOFF command to set a diskette or tape drive offline. When a diskette or tape 
drive is offline, the computer does not control it. When you vary a tape drive offline, the system 
rewinds the tape to the beginning. 

When you remove a diskette from a diskette unit, issue the $varyoff command to vary the slot 
used offline. Otherwise, EDX will continue to use that diskette. 

Syntax: 



$VARYOFF iodaslot 



Required; 
Default: 



ioda 
none 



J' 
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Operator Command Descriptions (continued) 



Operands Description 



ioda 
slot 



The hexadecimal device address of the diskette or tape device being varied offline. 

The number of the 4966 diskettes being varied offline. This parameter is valid only 
for the 4966 diskette unit. The valid slot numbers for the 4966 magazine unit are: 

All diskettes (1,2,3 , A,B) 

1 Slot 1 

2 Slot 2 

3 Slot 3 

A Magazine 1 
B Magazine 2 



$VARYON - Set Device Online 



jj(f*\^ 



o 



Use the $VARYON operator command to set a diskette or tape drive online. Use the $varyoff 
operator command to cancel each $varyon command. 

You do not have to enter $varyon when you put a new diskette into a 4964 or 4965 diskette 
unit. Your system automatically varies these devices onUne when you shut the door of the 
diskette unit. You must, however, issue the $varyon command before attempting to use a tape 
unit or a 4966 diskette unit. 

Syntax: 



$VARYON 


ioda slot 1 file EX 


Required: 


ioda 


Default: 


file defaults to 1 




maximum value of file is 255 



Operands Description 

ioda The hexadecimal device address of the diskette or tape device being varied online. 

slot The number of the 4966 slot containing the diskette being varied online. This 

parameter is valid only for the 4966 diskette unit. The valid slot numbers for the 
4966 magazine unit are: 

All diskettes (1, 2, 3, A, B) 

1 Slot 1 

2 Slot 2 

3 Slot 3 

A Magazine 1 
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Operator Command Descriptions (continued) 



fae 
EX 



B Magazine 2 

The decimal file number on the tape being accessed. 

Override the tape expiration date. If a tape data set is initiaUzed with an expiration 
date, EX must be used to be able to write to that tape data set. The file number 
must also be specified. 






The "file" and "ex" parameters are valid only for tape devices. 



$W - Display Date and Time 



Use the $w operator command to display the date and time, according to your edx system, on 
your display terminal. 

Syntax: 



$W 

Required: 
Default: 



none 
none 



Operands Description 
None 






c 
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Chapter 3. Session Manager 



The session manager provides access to system utilities and application programs from a display 
terminal. It uses a series of menu screens to direct you to the system utility you need and/or 
prompts you for parameters, such as data set names, needed by the option you chose. 

This chapter explains the session manager screens and options. It also contains a table that 
cross references the system utilities supported by the session manager to the appropriate menu 
option. 



o 
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Session Manager 



Invoking the Session Manager 



Menus 



The session manager must be active at your display terminal before you can use it. This can be 
accomplished by either loading it for that specific terminal, or having it loaded automatically 
during initial program load (ipl) of the edx system. When the session manager is loaded during 
IPL, EDX loads a copy for each display terminal recognized by the operating system. 

The session manager is loaded for a specific terminal using the $L operator command as follows: 
I > $L $SMMAIN 

To load the session manager automatically, you must rename the session manager initialization 
program from $sminit to $initial. This is done using the $diskuti re command as follows: 



v.. 



L 



COMMAND (?):RE $SMINIT $INITIAL 



When the session manager is loaded, it displays the logon menu shown in Figure 2 on page 
UT-33. 



The session manager menus, or display screens, list system facilities available through the 
session manager. They also display prompts for required parameters. 

The session manager has the following menus: 

Logon/logoff 
Primary option 
Secondary option 
Parameter input 
Custom 






.^ 



Logon/Logoff Menu 



The logon menu prompts you for a user ID and an optional alternate session menu if you are 
logging on to the session manager, or for the word LOGOFF if you are ending your session 
(logging off). 

Your user id must be 1 to 4 unique characters, such as your initials. The session manager uses 
your id as part of the data set names of six work data sets that it allocates for your session. It 
does not use your id as a password to verify that you are authorized to use the system. 



o 
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Menus (continued) 



The alternate session menu is an alternate menu that you want displayed instead of the primary 
option menu. An alternate session menu is available only if your copy of the session manager 
has been customized. (Refer to the Customization Guide for instructions on adding menus to the 
session manager.) 

r ~" ~^ ^ ^ 

$SMMLOG: THIS TERMINAL IS LOGGED ON TO THE SESSION MANAGER 

08:55:31 
ENTER 1-4 CHAR USER ID ==> 
(ENTER LOGOFF TO EXIT) 

ALTERNATE SESSION MENU ==> 
(OPTIONAL) 

Figure 2. Session manager logon/logoff menu 



Primary Option Menu 









The primary option menu lists all of the primary options provided with the session manager. If 
your session manager has been customized, you may have additional options, or the options may 
be different from the ones listed below. To select an option, enter the number of the option on 
the SELECT OPTION prompt Une. After you select a primary option, the session manager displays 
a secondary option or parameter input menu. (See Figure 3 on page UT-34 for an example of 
the primary option menu.) 

The basic options are: 

1. TEXT EDITING: Accesscs the $FSEDIT text editor. 

2. PROGRAM PREPARATION: Accesses the program preparation utilities. 

3. DATA MANAGEMENT: Accesses the Utilities for managing data on disk, diskette, or tape. 

4. TERMINAL UTILITIES: Accesses the terminal support utiUties. 

5. GRAPHICS UTILITIES: Accesses the utilities that generate, maintain, and display two- and 
three-dimensional fixed graphic backgrounds, and store them in data sets. 

6. EXEC PROGRAM/UTILITY: AUows you to load any program. The program can be an edx 
system program, an edx utility, or an application program. 

7. EXEC $JOBUTiL PROC: AUows you to load a previously built $jobutil procedure. 

8. COMMUNICATION UTILITIES: Accesses the utilities that support communications. 

9. DIAGNOSTIC AIDS: Accesses the utilities that help with problem determination. 

10. BACKGROUND JOB CONTROL UTILITIES: Accesses the job queue processing utilities. 
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Menus (continued) 



$SMMPRIM: SESSION MANAGER PRIMARY OPTION MENU 
ENTER/SELECT PARAMETERS: PRESS PF3 

SELECT OPTION ==> 

1 - TEXT EDITING 

2 - PROGRAM PREPARATION 

3 - DATA MANAGEMENT 

k - TERMINAL UTILITIES 

5 - GRAPHICS UTILITIES 

6 - EXEC PROGRAM/UTILITY 

7 - EXEC $JOBUTIL PROC 

8 - COMMUNICATION UTILITIES 

9 - DIAGNOSTIC AIDS 

10 - BACKGROUND JOB CONTROL UTILITIES 



TO EXIT 



Figure 3. Session manager primary option menu 



Secondary Option Menu 



A secondary option menu lists the utilities that are available under the related primary option. 
Primary options 2, 3, 4, 5, 8, 9, and 10 have secondary option menus. Figure 4 shows an 
example of the secondary option menu for primary option 2 - Program Preparation. 



To select a secondary option, enter the number of the option on the SELECT OPTION prompt line. 
After you select a secondary option, the session manager either displays a parameter input menu 
or loads the requested utility. 



r 



$SMM02: SESSION MANAGER PROGRAM PREPARATION MENU 
ENTER/SELECT PARAMETERS: PRESS PF3 TO RETURN 

SELECT OPTION ==> 

1 - $EDXASM COMPILER 

2 - $EDXASM/$EDXLINK 

3 - SSIASM ASSEMBLER 
k - $COBOL COMPILER 

5 - $FORT FORTRAN COMPILER 

6 - $PLI COMPILER/$EDXLINK 

7 - $EDXLINK LINKAGE EDITOR 

8 - $XPSLINK LINKAGE EDITOR FOR SUPERVISORS 

9 - $UPDATE 

10 - $UPDATEH (HOST) 

11 - $PREFIND 

12 - $PASCAL COMPILER/$EDXLINK 

13 - $EDXASM/$XPSLINK FOR SUPERVISORS 

1^4 - $MSGUT1 MESSAGE SOURCE PROCESSING UTILITY 



J 



■4 */ 



Figure 4. Example session manager secondary option menu 



G 
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Menus (continued) 



Parameter Input Menu 



c 



The parameter input menus prompt you for parameters, such as a data set and volume name, 
that are required by the requested utility. 

Primary options 1,6, and 7 have a parameter input menu but no secondary option menu. Figure 
5 contains an example of the parameter input menu for the $edxasm utility (primary option 2, 
secondary option 1). 

Enter the requested parameters in the format expected by the requested utility. 



$SMM0201: SESSION MANAGER $EDXASM PARAMETER INPUT MENU 

ENTER/SELECT PARAMETERS: PRESS PF3 TO RETURN 

SOURCE INPUT (NAME, VOLUME) ==> MYSRC.MYVOL 

OBJECT OUTPUT (NAME .VOLUME) ==> MYOBJ,MYVOL 

OPTIONAL PARAMETERS ==> LI TERM2 
(SELECT FROM THE LIST BELOW) 

FOREGROUND OR BACKGROUND (F/B) ==> F 
(DEFAULT IS FOREGROUND) 



AVAILABLE PARAMETERS: 
NOLI ST 

LIST TERMINAL-NAME 
ERRORS TERMINAL-NAME 
CONTROL DATA SET, VOLUME 
OVERLAY # 



ABBREVIATION: 
NO 

LI TERMNL-NAME 
ER TERMNL-NAME 
CO DATA SET, VOL 
OV § 



DESCRIPTION: 
USED TO SUPPRESS LISTING 
USE LIST * FOR TERMNL 
USE ERRORS * FOR TERMNL 
$EDXASM LANGUAGE CONTROL 
NUMBER OF AREAS FROM 1 - 



DEFAULT PARAMETERS: 
LIST $SYSPRTR CONTROL $EDXL,ASMLIB OVERLAY k 



Figure 5. Example session manager parameter input menu 
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Menus (continued) 

.J 



The Background Option 



Custom Menus 



Figure 5 shows that you can specify either the background or foreground option. This choice is 
offered with options 2.1, 2.2, 2.7, 2.8, 2.13, 6, and 7. If you run a job in foreground, you 
cannot use your terminal until the job has completed. Foreground is adequate for small jobs. 
However, if you don't want to tie up your terminal waiting for a large job to complete, run in 
background and the job will run on another terminal. Then you can continue to use your 
terminal for another job. 

If you try to code anything except an "F" or a blank for foreground or a "B" for background, 
you will receive an "INVALID PARAMETER INPUT" message. 

To submit a job through the background options of 10.1 or 10.2, the system must load the batch 
control manager, $JOBQ. For a job to execute in background, 8K bytes of storage must be 
available. 

r 

SSMMIO: SESSION MANAGER BACKGROUND UTILITIES OPTION MENU 

ENTER/SELECT PARAMETERS: PRESS PF3 TO RETURN 

SELECT OPTION ==> 2 

1 - SJOBQUT SJOBQ PROCESSING CONTROLLER 

2 - $SUBMIT SJOBQ JOB SUBMISSION UTILITY 

Figure 6. Example secondary option menu for primary option 10 

Note: See the $JOBQUT and $SUBMIT utilities for the screen examples. L ) 

The session manager allocates one additional work data set for the entire system to use for 
background processing. When you log onto the system, the session manager checks to see if this 
work data set exists already. If it doesn't, the session manager allocates 400 records for the data 
set. If the data set already exists, the session manager continues as usual. Every job submitted 
in background that needs a work data set will use this preallocated data set. Since only one job 
can run background at a time, there is no problem. If you delete this data set, the session 
manager will reallocate it when the next user logs on. 

Note: If you never intend to run background jobs, your system manager can move this entry 
after the end statement in the data set $SMALLOC, EDX002 with $FSEDIT. 



You can add your own custom menus which give you access to your appUcation programs with 
the session manager. Refer to the Customization Guide for instructions on customizing the 
session manager. 



.^■' 
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Data Sets 



The session manager uses the following six work data sets for each person that is logged-on. (If 
your session manager has been tailored as described in the Customization Guide, additional data 
sets may be used.) 

$SMEuser 

$SMPuser 

$SMWuser 

$ SMI user 

$SM2user 

$SM3user. 

The data sets are allocated after you enter your user id on the logon menu, unless they were 
saved at the end of a previous session. The session manager uses your user ID as part of the data 
set name, creating a unique set of data sets for each user. 
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Data Sets (continued) 



When you log off, the session manager gives you an opportunity to erase all work data sets 
except $SMPuser. If you chose to save the data sets, the information they contain will be 
available the next time you sign on with the same user id. Figure 7 lists the six basic 
session-manager data sets, their sizes, and their purpose. 



Data set 
name 


Size in 

256-byte 

records 


Purpose 


$SMEuser 


400 


Used by the full-screen text editor ($fsedit) as a work data set. 


$SMPuser 


30 


Used by the session manger to save your input paranneters. This data set is not 
deleted at the end of a session, making your parameters available for the next 
session. 


$SMWuser 


30 


Used by the session manger to submit procedures via the job procedure utility 

(SJOBUTIL). 


$SM1useri 


400 


Used by $siasm, $edxasm, $cobol, $pl/i, $pascal and $fort as a work data set. 


$SM2useri 


400 


Used by $edxlink, $siasm, $edxasm, $xpslink, $cobol, $pl/i, and $fort as a work 
data set. 


$SM3useri 


250 


Used by the Series/ 1 Macro Assembler ($siasm), $cobol, $pascal, and $pl/i as a 
work data set. 



Figure 7. Session manager data sets 

Note: If you use option 2.8 or 2.13, the session manager expands $SM2user to 600 records and 
then resets it to 400 records. 



/""'N 
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Program Function Keys 



The session manager has four program function (PF) keys defined for special use: pfi, pf2, pf3, 
and PF4. They perform the following functions: 

PFI Suspends the session manager, allowing you to enter operator commands. Suspending the 
session manger is quicker than logging off and back on. To restart the session manager, 
press the attention key, and enter $SM. The session manager returns to the menu you were 
using when you pressed the PFl key. 



These data sets must be deleted and reallocated to new sizes when using the session manger to invoke 
compilers and assemblers. Recommended sizes for most programs are 2000 records for $smi user and 
$SM2USER and 800 records for $sm3USer. 
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Program Function Keys (continued) 



When you press the pfi key, the session manager displays the following messages: 



ENTERING SYSTEM COMMAND MODE - 
TO REENTER THE SESSION MANAGER, 
DEPRESS THE ATTN KEY AND ENTER "$SM" 



PF2 Restores the current menu screen to its appearance when first displayed. Use this key to 
erase incorrect entries. 

PF3 Returns to the previous menu. 

PF4 Return directly to the primary option menu. 



Supported Utilities 



The following table lists the EDX system utilities that are supported by the session manager and 
the primary and secondary option numbers for each. (See Figure 1 on page UT-3 for a table 
which includes a list of the jobs that can be done with the session manager, including the 
appropriate primary and secondary option numbers for each.) 

Note: The session manager menus are independent of the edx supervisor installed on 
your EDX system. Therefore, all the utilities Usted on the menu screens may not be a 
part of your system. 



Utility 


Description 


Options 


$ARJE 


Advanced RJE program and utilities 


8.10 


$BSCTRCE 


Trace I/O activity on a BSC line 


8.1 


$BSCUT1 


Format BSC trace files 


8.2 


$BSCUT2 


Communications I/O exerciser 


8.3 


$CHANUT1 


Channel attach utility 


8.9 


$COBOL 


COBOL language compiler 


2.4 


SCOMPRES 


Compress disk, diskette, or volume 


3.4 


$COPY 


Copy data set or volume 


3.5 



Figure 8 (Part 1 of 3). Session Manager Options by Utility 
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Supported Utilities (continued) 



Utility 


Description 


Options 


$C0PYUT1 


Copy data set with allocation 


3.3 


$DASDI 


Format disk or diskette 


3.6 


$DICOMP 


Display and change graphics profiles 


5.2 


$DIINTR 


Graphics interpreter 


5.3 


$DISKUT1 


Allocate, delete, list data set directory data 


3.1 


$DISKUT2 


Patch, dump, or list a data set or program a data set 
or program 


3.2, 9.2 


$DIUTIL 


Maintain partitioned data base 


5.1 


SDUMP 


Format and list saved environment 


9.1 


$EDXASM 


Event Driven Language Compiler 


2.1 


$EDXASM/$EDXLINK 


Compile and link 


2.2 


$EDXASM/$XPSLINK 


Compile and link a supervisor program 


2.13 


$EDXLINK 


Linkage editor 


2.7 


$FONT 


Process 4974, 4978, and 4980 character image 
tables 


4.5 


$FORT 


FORTRAN language compiler 


2.5 


$FSEDIT 


Full-screen editor 


1 


$GPIBUT1 


General purpose interface bus utility 


4.9 


$HCFUT1 


Interact with Host Communications Facility 


8.8 


$HXUT1 


H exchange diskette utility 


3.11 


$IAMUT1 


Indexed Access Method Utility 


3.9 


$IMAGE 


Define 4978, 4979, 4980 or 3101 screen image 


4.4 


$INITDSK 


Initialize disk or diskette, and volume control 


3.7 


$IOTEST 


Test sensor I/O; list hardware configuration 


9.3 


$JOBUTIL 


Job stream processor 


7 



Figure 8 (Part 2 of 3). Session Manager Options by Utility 
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Supported Utilities (continued) 






Utility 


Description 


Options 


$JOBQUT 


Job queue processing controller 


10.1 


$MOVEVOL 


Disk volume dump and restore 


3.8 


$MSGUT1 


Message-source processing 


2.14 


$PASCAL/$EDXLINK 


Pascal language compile and link 


2.12 


$PFMAP 


Display 4978 and 4980 PF key codes 


4.6 


$PLI/$EDXLINK 


PLI language compile and link 


2.6 


$PREFIND 


Prefind data sets and EDL overlays 


2.11 


$PRT2780 


2780 spooled RJE file printer 


8.6 


$PRT3780 


3780 spooled RJE file printer 


8.7 


$RJE2780 


2780 remote job entry to host 


8.4 


$RJE3780 


3780 remote job entry to host 


8.5 


$SPLUT1 


Spool utility 


4.7 


$SUBMIT 


Job queue job submission utility 


10.2 


$S1ASM 


Series/ 1 assembler 


2.3 


$S1S1UT1 


Series/1 to Series/1 


4.8 


$TAPEUT1 


Tape management 


3.10 


$TERMUT1 


Change terminal parameters 


4.1 


$TERMUT2 


Change 4974, 4978, and 4980 image or control 
store 


4.2 


$TERMUT3 


Send message to a terminal 


4.3 


$UPDATE 


Converting Series/ 1 programs 


2.9 


$UPDATEH 


Convert host system programs 


2.10 


$VERIFY 


Verify Indexed Access Method Files 


9.4 


$XPSLINK 


Link a supervisor program 


2.8 



Figure 8 (Part 3 of 3). Session Manager Options by Utility 
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Chapter 4. Utilities 
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The system utilities are a set of programs supplied with the Event Driven Executive. They allow 
you to interactively communicate with the system and perform tasks necessary for Series/ 1 
application program development and system maintenance. 

This chapter provides detailed descriptions (in alphabetical order) of the EDX system utility 
programs. 



Invoking the Utilities 



The Event Driven Executive provides three ways to invoke the utility programs from a terminal: 



Session manager 



You choose the desired utility program from a predefined option menu. 
This is the easiest to use for interactive utilities because you only enter 
option numbers (not program names) to access the function needed. 



$JOBUTIL 



The job stream processor utility is used to invoke a predefined sequence of 
utility programs and to pass parameters to those programs. $J0BUTIL can 
be invoked by the $L operator command or the session manager. 



$L command Enter the operator command $L (load program), followed by the utility 

name. All utilities described in this chapter can be invoked using $L. 
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Invoking the Utilities (continued) 






Any utility invoked results in a loading message being displayed. The following example is for 
illustrative purposes only. 



I 



LOADING UTILITY xP, 00:00:00, LP= 0000, PART= number 



J 



Here, utility is the name of the utiUty being loaded. xP indicates the size of the utility in pages 
(256 bytes equals one page). 00.00.00 is the time in hours, minutes, and seconds. LP= 0000 
indicates that the load point of the utility is at location X'OOOO', and part= number indicates 
the partition in which the utility is loaded. If timer support is not included in your supervisor, 
the time is not printed. 

Most utility programs are used interactively from a terminal. If you are not familiar with the 
commands available under a specific utility, you can enter a question mark in response to the 
COMMAND (?) : prompt and press the enter key. A list of the available commands for that utility 
is displayed. 



Entering Utility Commands 



You can enter utility commands in one of two ways — prompt-reply or single-line format. With 
prompt-reply format, you enter the command name and each parameter as the system asks for 
it. With single-line format, you enter the command name and all the parameters on the same 
line. The following examples show you how to use the two formats. 



Prompt/Reply Format 






Type the utility command following the COMMAND (?): prompt and press the enter key. EDX 
responds with a prompt for the next parameter as each parameter is entered. 



r 



COMMAND (?): CV 

COPY VOLUME 

ENTER SOURCE VOLUME: IBMEDX 
ENTER TARGET VOLUME: EDX002 
ENTER TARGET DATA SET NAME: DATAl 
ARE ALL PARAMETERS CORRECT? Y 
COPY COMPLETE 

3k3 RECORDS COPIED 

COMMAND (?): 



\J 
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Invoking the Utilities (continued) 



Single Reply Entry 



Type the command name and all the required parameters (information) needed by the command 
to perform its function following the command (?): prompt and press the enter key. When 
using the single reply entry, the parameters must be entered in the order that the edx expects 
them. 

COMMAND (?): CV IBMEDX EDX002 DATAl Y 
COPY COMPLETE 

9i»9 RECORDS COPIED 

COMMAND (?): 



Cancelling a Utility 






Use the $c operator command to cancel a utility program running in the same partition as your 
terminal. If $C should not be used to cancel a utility, the utility warns you on the first screen it 
displays. 

To cancel a utility with the $c operator command: 

1) Press the attention key. 

2) EDX responds with the greater-than sign (>). 

3) Enter the $c operator command. 

4) Press the enter key. 
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$BSCTRCE - Trace I/O Activity on a BSC Line 



The $BSCTRCE utility traces the I/O activities on a given binary synchronous communication 
(bsc) Une. You must load $bsctrce in the same partition as the application program that is 
controlling the traced Une. If you load it in any other partition, you will get unpredictable 
results. 



Invoking $BSCTRCE 

You invoke $BSCTRCE with the $l command or option 8.1 of the session manager. 

After you load $bsctrce, it prompts you for the disk or diskette file in which to place the trace 
output. $BSCTRCE then prompts you for the line number you want traced. Use the attention 
command STOP to end the trace action. 



$L $BSCTRCE 

DS1( NAME, VOLUME): TRACES 
LOADING $BSCTRCE 6P, 11:03:22, LP=6500, 
ENTER LINE NUMBER (HEX): 9 



> STOP 



PART=2 



V. 



LAST TRACE RECORD EQUALS 19 
$8SCTRCE ENDED AT 11:13:31 



When the system reaches the end of the output file, it reuses it from the beginning, since 
$BSCTRCE displays the relative record number of the last trace record it wrote before it ended. 
You can display or list the trace file by using the $BSCUTl utility. 

$BSCTRCE writes trace file records at the completion of a BSC operation. Therefore, for a 
conversational bscwrite, if you specify the same buffer address for both input and output, the 
trace file does not show the data that the system transmitted; it shows only the data that it 
received. 

Multiple BSC lines may be traced concurrently with multiple loads of $bsctrce using different 
trace files. Each copy of $BSCTRCE must use a different trace data set. We recommend that 
each trace data set name reflect a unique line number. 

When $bsctrce ends, it displays the relative record number of the last trace record it wrote. 
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$BSCTRCE - Trace I/O Activity on a BSC Line (continued) 



Record Format 



The format of the records produced by $bsctrce is shown below. 



cc 


ISW 


STATUS 


DCB 


LGTH 


DATA 


LAST4 



+2 +^ 



+10 +26 +28 +252 






CC Interrupt condition code on completion of the I/O. 

ISW Interrupt status word on completion of the I/O. 

STATUS The three status words of the BSC adapter (produced when bit of the ISW is on). 

DCB The device control block for the I/O. 

LGTH The length of the data sent/received. 

DATA The data in main storage following the I/O. 

LAST4 The last 4 bytes of data if the data is longer than 227 bytes. 

Note: The CC, ISW, and STATUS fields are zero when the DCB has been chained from the 
previous record's DCB. 

Refer to the IBM Series/ 1 Communications Features Description, GA34-0028, for descriptions 
of the interrupt condition code, interrupt status word, the three cycle steal status words, and the 
device control block. 
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$BSCUT1 - Format BSC Trace Files 



The $BSCUTl utility formats BSC trace files (see $BSCTRCE utility) for printing to either $sysprtr 
or a terminal. You can select the record for the trace file to dump. The system will prompt you 
as necessary for information that the functions of $BSCUTl require. 



Invoking $BSCUT1 

You invoke $BSCUT1 with the $L command or option 8.2 of the session manager. 
$BSCUT1 Commands 

To display the $bscuti commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?):. 



r 



> $L $BSCUT1 
LOADING $BSCUT1 

USING VOLUME EDX002 

COMMAND(?): ? 



CV - CHANGE VOLUME 

DP - PRINT TRACE FILE ON PRINTER 

DU - DUMP TRACE FILE ON TERMINAL 

(CA WILL CANCEL) 
EN - END PROGRAM 



21P, 00:04:21, LP= 9200, PART=1 



COMMAND (?): 



After $BSCUTl displays the commands, it prompts you with COMMAND (?):. Then you can 
respond with the command of your choice (for example, cv). 

Example: Figure 9 on page UT-49 shows invoking and using SBSCUTl to display specified 
trace data records. 






o 
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$BSCUT1 - Format BSC Trace Files (continued) 






Q 

IB 



COMMAND (?); DU TRACES 
FIRST RECORD: 32 
LAST RECORD: 33 

DUMP OF TRACE FILE TRACES ON EDX002 

***** RECORD 32 "**"* START OF CHAINED OPERATION 

CC = 0002 ISW = A009 STATUS = 98DA 0001 CO8O 
RESULT: EXCEPTION - WRONG LENGTH RECORD (SHORT) 

DCB = 8004 0000 0000 0000 0000 2B1C 0002 2AE4 
OPERATION: CHAINED TRANSMIT 

DATA LENGTH = 2 
1 1061 



RECORD 33 



ju Jt.a.x ju 



CONTINUATION OF CHAINED OPERATION 



DCB = 2008 0000 0000 0000 0000 0000 0200 96F6 
OPERATION: RECEIVE WITH TIMEOUT 



DATA LENGTH = 



1 

17 

33 

k3 

65 

81 

97 



0227 615B 
4040 F4F2 
E7C5 C3E4 
40F7 1E27 
D6C2 4040 
40C5 E7C5 
D640 40F7 
113 40D1 D6C2 
129 F4F5 40C5 
145 D9C9 D640 
161 F3F4 40D1 
177 FOFl F040 
193 D7D9 C9D6 
209 4BF3 F440 
LAST 4 D4D5 1 

DUMP COMPLETE 
ANOTHER AREA? 



485 
F1F6 4BF5 
F440 D7D9 
E3C9 D5C7 
615B F1F6 
F4F2 F340 
C3E4 E3C9 
1E27 615B 
4040 F3F0 
E7C5 C3E4 



40F5 
D6C2 



1E27 
1D43 



D6D5 40D7 
4040 F51E 
D1D6 C240 
E26 



F94B F3F4 
F3F0 F1F6 
40D4 40D7 
4BF5 F94B 
C8D8 F1F2 
D5C7 40D4 
F1F6 4BF5 
F040 C9E2 
E3C9 D5C7 
615B F1F6 
F4F8 407B 
D9C9 D5E3 
2761 5BF1 
40F3 F2F0 



40D1 D6C2 
F5F6 40C5 
D9C9 D640 
F3F4 4001 
F1F6 F5F6 
40D7 D9C9 
F94B F3F4 
F0F3 F1F4 
40E5 40D7 
4BF5 F94B 
C7E2 D7C5 
D9F2 4040 
F64B F5F9 
40C6 C7F6 



../$16.59.34 JOB 
424 PR301656 E 
XECUTING M PRIO 

7../$l6.59.34 J 
OB 423 HQ121656 

EXECUTING M PR I 
7../$l6.59.34 

JOB 300 IS0314 
45 EXECUTING V P 
RIO 5../$l6.59. 
34 JOB.. 48 #GSPE 
010 ON PRINTR2 
PRIO 5../$l6.59 
.34 JOB 320 FG6 
MN.. 



Figure 9. Dumping BSC trace records to a terminal 

m The command for printing the selected records is dp; the command for dumping records to a 
terminal is DU. THIS example uses du. 

Q You can select a specific range of records for $bscuti to display. Enter the first and last 
record numbers as the utility requests them. Figure 9 on page UT-46 shows that when 
$BSCTRCE ends, it displays the last trace record number. This information provides you with the 
range of record numbers that are available in the $bsctrce data set. 

Q The system displays the record number along with the type of bsc operation it represents. 
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$BSCUT1 - Format BSC Trace Files (continued) 



Q This line provides 3 items of diagnostic information: 

CC This is the interrupt condition code. In this example the 2 is the condition code 

returned and indicates an exception condition. 

ISW The interrupt status word represents the interrupt status byte in the left-most byte. 

STATUS The 3 words of status are the values stored in the cycle steal status words (cssw) 

for the BSC adapter. The CSSWs contain valid diagnostic information when the isw 
bit is set to 1 . 

The detailed descriptions of these codes are contained in the IBM Series/ 1 Communications 
Features Description, GA34-0028. 

When analyzing the trace records, you must remember that the system writes the trace records 
after the BSC operation completes. Therefore, the error indications may not relate directly to the 
record with which they are formatted and printed but will relate to the operation as a whole. 

Q This line provides a brief interpretation of the condition code field and the interrupt status 
byte. 

Q These 8 words represent the values stored in the device control block (dcb). Their 
meanings are described in detail in the IBM Series/ 1 Communications Features Description, 
GA34-0028. 

Q This hne provides a brief interpretation of what operation was performed by the device 
control block whose values are represented on the previous line. 

Q This is the number of bytes of data that the current operation receives. 

01 This is the first byte of data in the record the system is displaying. Notice that in record 
number 33 of the example, the data length = 485 (bytes). Also, the left-most column of the 
record's data that the system is displaying shows the first byte position of each line in decimal 
values. When the data length of a trace record exceeds 227 bytes, the system displays only 
the first 224 bytes of data followed by 'last 4' and the last 4 bytes of the data record. 

QQ This is the beginning of the display for LAST RECORD selected in the example, record number 
33. 



%-.. -^ 
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$BSCUT2 - Communications I/O Exerciser 

The $BSCUT2 utility is primarily an I/O exerciser and is used to verify the following: 

• Binary synchronous communications access method (bscam) 

• BSCLINE definitions generated in the executing supervisor 

• Customized jumper assignments in the BSC hardware features, such as: 

— device address 

— type of connection 

— tributary station address. 

You can use $BSCTRCE to trace the exercising activities of $bscut2. You can format and print 
the records with $bscuti. 

For each function you select in $BSCUT2, the system prompts you for the device (line) address, 
tributary station address (if multipoint), record length, and other related information. If any 
discrepancies exist between the function you are performing and the hardware assignments, the 
system prints error messages. 

$BSCUT2 checks out binary synchronous operations if at least two binary synchronous adapters 
are available on Series/ 1 processors and if you make the connection between the two adapters. 
If you use a switched manual connection, $BSCUT2 does not prompt you to make the connection. 
*\ This must be done after you issue the $BSCUT2 command and answer all prompts. 



.y 



The BSCAM capabilities that $BSCUT2 can test are: 

• Read and write of both transparent and nontransparent data 

• Operation in limited conversational mode with both transparent and nontransparent data 

• Operation as a control station on a multipoint line to both poll and select tributaries (text 
written only for transparent data) 

• Operation as a tributary station on a multipoint line to be polled and selected (text written 
only for transparent mode) 

Test Pattern Messages 

$BSCUT2 issues a test pattern message for every record it read or wrote in a test. 

The first line of a test pattern message gives the task name, record number, and record length. 

The second line shows the alphabet repeated to fill up the number of characters specified for 
record length. 
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$BSCUT2 - Communications I/O Exerciser (continued) 



TASK READ ENTERED RECORD NUMBER= 1 RECORD LENGTH= 72 

ABCDEFGH I JKLMNOPQRSTUVWXYZABCDEFGH I JKLMNOPQRSTUVWXYZABCDEFGH 1 JKLMNOPQRST 



The meanings of the task names are as follows: 

• READ - read of standard or transparent data in standard mode 

• RXVl - read of transparent data in conversational mode 

• RNVl - read of standard data in conversational mode 

• WRTN - write of standard data in standard mode 

• WRIT - write of transparent data in standard mode 

• WXVl - write of transparent data in conversational mode 

• WNVl - write of standard data in conversation mode 

• MTXl - read of transparent data by a tributary station 

• MCXl - write of transparent data by a control station 

The system repeats the output message in the previous example for the number of records 
transmitted. 



i4 



Invoking $BSCUT2 

You invoke $BSCUT2 with the $L command or option 8.3 of the session manager. 



> $L $BSCUT2 
LOADING $BSCUT2 76P ,00:05 : 3 1 , LP= 9200, PART=1 



O 
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$BSCUT2 - Communications I/O Exerciser (continued) 

$BSCUT2 Commands 

To display the $bscut2 commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 

COMMAND (?): ? 

RWI READ/WRITE - NONTRANSPARENT 

RWIX — - READ/WRITE - TRANSPARENT 

RWI MP -- READ/WRITE - MULTIDROP LINE NONTRANSPARENT 

RWIXMP - READ/WRITE - MULTIDROP LINE TRANSPARENT 

Rl READ - TRANSPARENT/NONTRANSPARENT 

Wl WRITE - NONTRANSPARENT 

WIX WRITE - TRANSPARENT 

EN END THE PROGRAM 

CH CHANGE HARDCOPY DEVICE 

RWIVX -- READ/WRITE - TRANSPARENT CONVERSATIONAL 

RWIV -- READ/WRITE - NONTRANSPARENT CONVERSATIONAL 

V 

After $BSCUT2 displays the commands, it prompts you with command (?):. Then you can 
respond with the command of your choice (for example, ri.) 

Most of the commands and their explanations are presented in alphabetical order on the 
following pages. 

CH — Change Hard-copy Device 

Use the CH command to reassign the hard-copy device for the terminal or printer output. 

Example: 

COMMAND (?): CH 

NEW HARD-COPY DEVICE? SSYSLOGA 



Note: If the hard-copy device you specified is not defined, the system directs the output to the 
terminal where you loaded $BSCUT2. 

EN — End $BSCUT2 Program 

Use the en command to end the $BSCUT2 utility. 

Example: 

COMMAND (?): EN 

$BSCUT2 ENDED AT 01:14:^0 
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$BSCUT2 - Communications I/O Exerciser (continued) 

Rl — Read Transparent/Nontransparent 

The read task does not require number of records since it will read either transparent or 
nontransparent data until the system receives EOT. This makes the read task useful for 
monitoring any BSC line sending data to the processor. For example, Ri can receive data from 
the $RJE2780 or $RJE3780 Utility operating in the same Series/ 1 or in another Series/ 1. 

Note: The Ri, wi, and wix commands individually activate the tasks composing RWI and RWix. 






Example: 



COMMAND (?): f 

RI READ - 

READ ADDRESS? 
READ RECL? 80 
READ MONITOR? 



TRANSPARENT/NONTRANSPARENT 
5A 



RWI — Read/Write Nontransparent Data 



Use the RWI command to read and write nontransparent messages on a hne. The system 
numbers each message. The record length for write includes the control characters. The read 
task receives the messages, analyzes them, and prints them on a hard-copy device. The analysis 
includes whether they are transparent or nontransparent and record length received. 

Example: 






COMMAND (?): RWI 

RWI READ/WRITE 

READ ADDRESS? 5A 
WRITE ADDRESS? 5B 
READ RECL? 80 
WRITE RECL? 80 
NUMBER OF RECORDS? 
READ MONITOR? Y 
WRITE MONITOR? Y 

V. 



NONTRANSPARENT 



10 



READ ADDRESS and WRITE ADDRESS refer to the device address of the bsc hardware feature. If 
you are going to run the test between two processors (one to read and one to write), load 
$BSCUT2 on both processors and enter the correct address for read on one processor and the 
correct address for write on the other processor. One of the addresses can be invalid and the 
task for the invalid address on each processor will fail due to an undefined line. However, the 
read/ write task will function properly. This is true for all $BSCUT2 commands. 
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$BSCUT2 - Communications I/O Exerciser (continued) 

The RECL prompts refer to the buffer size the system will use and, therefore, the number of 
bytes the system will transfer in one transmission over the BSC line. The maximum buffer size 
the system permits is 512 bytes, read (recl) should always be equal to or greater than write 
(RECL) or errors will occur. 

number of records determines the number of transmissions the system will make before the 
test ends. 

The MONITOR function causes each task to report its progress to the terminal. If you enable the 
monitor function, the system writes messages such as task entered and task exited to the 
terminal. 

RWIV — Read/Write Nontransparent Conversational 

Use the RWiv to test limited conversational operation in nontransparent mode. BUFFER length 
is equivalent to RECL. 

Example: 

COMMAND (?): RWIV 

RWiV --- READ/WRITE - NONTRANSPARENT CONVERSATIONAL 

READ ADDRESS? 5B 

WRITE ADDRESS? 5A 

BUFFER LENGTH? 80 

NUMBER OF RECORDS? 5 

READ MONITOR? Y 

WRITE MONITOR? Y 

< , 

READ ADDRESS and WRITE ADDRESS refer to the device address of theBSC hardware feature. If 
you are going to run the test between two processors (one to read and one to write) , load 
$BSCUT2 on both processors and enter the correct address for read on one processor and the 
correct address for write on the other processor. One of the addresses can be invalid and the 
task for the invalid address on each processor will fail due to an undefined line. However, the 
read/write task will function properly. This is true for all $BSCUT2 commands. 

The RECL prompts refer to the buffer size the system will use and, therefore, the number of 
bytes the system transfers in one transmission over the BSC line. The maximum buffer size the 
system permits is 5 12 bytes. READ (RECL) should always be equal to or greater than WRITE 
(RECL) or errors will occur, number of records determines the number of transmissions the 
system will make before the test ends. The MONITOR function causes each task to report its 
progress to the terminal. If the the system enables the monitor function, it writes messages such 
as TASK ENTERED and TASK EXITED to the terminal. 
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$BSCUT2 - Communications f/O Exerciser (continued) 



The following is a description of the binary synchronous line transactions: 






WRITE TASK 
BSCWRITE IV(X) 

BSCREAD C 
BSCWRITE CV(X) 
BSCWRITE CV(X) 
BSCREAD C 



ENQ > 

< ACKO (Response)- 

Text > 

< Text (Response) — 

ACK1 (Response)-> 

< Text 

Text (Response)-> 

< ACKO (Response)-- 

Text > 

< Text 

ACKl > 



READ TASK 
BSCREAD I 

BSCWRITE CV(X) 
BSCWRITE CV(X) 
BSCREAD C 
BSCWRITE CV(X) 



This sequence continues until the NUMBER OF RECORDS count is satisfied. 

RVViVX — Read/Write Transparent Conversational 

Use the RWIVX command to test limited conversational operation in transparent mode. Each 
message is numbered. The record length for write includes the control characters. The read 
task receives the messages, analyzes them, and prints them on a hard-copy device. The analysis 
includes whether they are transparent or nontransparent and record length received, buffer 
LENGTH is equivalent to recl. 

Example: 



\.J 



COMMAND (?): RWIVX 
RWIVX -- READ/WRITE 
READ ADDRESS? 5A 
WRITE ADDRESS? 5B 
BUFFER LENGTH? 5 
NUMBER OF RECORDS? 
READ MONITOR? Y 
WRITE MONITOR? Y 



TRANSPARENT CONVERSATIONAL 



10 



v^ 



read address and write address refer to the device address of the BSC hardware feature. If 
the test is to be run between two processors (one to read and one to write), load $bscut2 on 
both processors and enter the correct address for read on one processor and the correct address 
for write on the other processor. One of the addresses can be invalid and the task for the invalid 
address on each processor will fail due to an undefined hne. However, the read/write task will 
function properly. This is true for all $bscut2 commands. 

The recl prompts refer to the buffer size to be used and, therefore, the number of bytes 
transferred in one transmission over the BSC line. The maximum buffer size permitted is 512 
bytes. READ (RECL) should always be equal to or greater than write (RECL) or errors will occur. 
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$BSCUT2 - Communications I/O Exerciser (continued) 



NUMBER OF RECORDS determines the number of transmissions to be made before the test ends. 

The MONITOR function causes each task to report its progress to the terminal. If the monitor 
function is enabled, messages such as task entered and task exited are written to the 
terminal. 

The following is a description of the binary synchronous line transactions: 



WRITE TASK 
BSCWRITE 1V(X) 

BSCREAD C 
BSCWRITE CV(X) 
BSCWRITE CV(X) 
BSCREAD C 



ENQ > 

< ACKO (Response)- 

Text > 

< Text (Response)-- 

ACKl (Response)-> 

< Text 

Text (Response)-> 

< ACKO (Response)-- 

Text > 

< Text 

ACKl > 



READ TASK 
BSCREAD I 

BSCWRITE CV(X) 
BSCWRITE CV(X) 
BSCREAD C 
BSCWRITE CV(X) 






This sequence continues until the number OF RECORDS count is satisfied. 
RWIX — Read/Write Transparent Data 

Use the RWIX command to read and write transparent messages on a line. Each message is 
numbered. The record length for write includes the control characters. The read task receives 
the messages, analyzes them, and prints them on a hard-copy device. The analysis includes 
whether they are transparent or nontransparent and record length received. 

Example: 



o 



r 



COMMAND (?): RWIX 
RWIX --- READ/WRITE - 
READ ADDRESS? 5A 
WRITE ADDRESS? 5B 
READ RECL? 80 
WRITE RECL? 80 
NUMBER OF RECORDS? 10 
READ MONITOR? Y 
WRITE MONITOR? Y 



TRANSPARENT 
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$BSCUT2 - Communications I/O Exerciser (continued) 



READ ADDRESS and WRITE ADDRESS refer to the device address of theBSC hardware feature. If 
you are going to run the test between two processors (one to read and one to write), load 
$BSCUT2 on both processors and enter the correct address for read on one processor and the 
correct address for write on the other processor. One of the addresses can be invaUd and the 
task for the invalid address on each processor will fail due to an undefined hne. However, the 
read/ write task will function properly. This is true for all $BSCUT2 commands. 

The RECL prompts refer to the buffer size the system will use and, therefore, the number of 
bytes transferred in one transmission over the ESC line. The maximum buffer size the system 
permits is 512 bytes. READ (RECL) should always be equal to or greater than WRITE (RECL) or 
errors will occur. 

NUMBER OF RECORDS determines the number of transmissions the system will make before the 
test ends. 

The MONITOR function causes each task to report its progress to the terminal. If the system 
enables the monitor function, it writes messages such as TASK ENTERED and TASK EXITED to the 
terminal. 

RWIXMP — Read/Write Transparent, Multidrop Line 

Use the rwixmp command to read and write transparent messages on a multidrop line. Each 

message is numbered. The record length for write includes the control characters. The read 

task receives the messages, analyzes them, and prints them on a hard-copy device. The analysis 

includes whether they are transparent or nontransparent and record length received. /" 



READ ADDRESS and WRITE ADDRESS refer to the device address of the BSC hardware feature. If 
the test is to be run between two processors (one to read and one to write), load $BSCUT2 on 
both processors and enter the correct address for read on one processor and the correct address 
for write on the other processor. One of the addresses can be invalid and the task for the invalid 
address on each processor will fail due to an undefined line. However, the read/write task will 
function properly. This is true for all $BSCUT2 commands. 

The RECL prompts refer to the buffer size to be used and, therefore, the number of bytes 
transferred in one transmission over the BSC line. The maximum buffer size permitted is 512 
bytes. READ (RECL) should always be equal to or greater than write (RECL) or errors will occur. 

NUMBER OF RECORDS determines the number of transmissions to be made before the test ends. 

The MONITOR function causes each task to report its progress to the terminal. If the monitor 
function is enabled, messages such as task entered and task exited are written to the 
terminal. 



\J 
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$BSCUT2 - Communications I/O Exerciser (continued) 



In the following example, the control station (mc) at device address 50 polls and selects all 
tributary stations (mt) and sends and receives messages to them. Since each task both transmits 
and receives, successful operation requires the control station length to equal all tributary station 
buffer lengths. Values other than this can be entered to test access method error detection. 
Received messages are logged to the hard-copy device. 

Example: 

r — 



(?): RWIXMP 
READ/WRITE - MULTIDROP LINE TRANSPARENT 



COMMAND 

RWIXMP 

MC DEVICE ADDRESS? 50 

BUFFER LENGTH? 80 

NUMBER OF RECORDS? 5 

LOOP COUNT? 1 

MONITOR? Y 

NUMBER OF TRIBUTARIES? 



PARAMETERS FOR TRIBUTARY? 1 
MT DEVICE ADDRESS? 51 
MT TRIBUTARY ADDRESS? 02 
BUFFER LENGTH? 80 
NUMBER OF RECORDS? 5 
MONITOR? Y 



DEVICE ADDRESS for this Command refers to the device address of the BSC hardware feature. 
TRIBUTARY ADDRESS refers to the jumpered tributary address on each hardware feature card. 
LOOP COUNT refers to the number of times $bscut2 sends the messages that you have specified. 

Note: The adapter must be jumpered in tributary mode for this test to function properly. 

If this test is to be performed between two $BSCUT2 programs then: 

• Program 1 would use a vaUd MC device address and dummy tributaries (mt). 

• Program 2 would use a dummy MC device address and valid tributaries (mt). 

• NUMBER OF TRIBUTARIES must be equal in both programs. 

• LOOP COUNT must be equal in both programs. 
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$BSCUT2 - Communications I/O Exerciser (continued) 

Wl — Write Nontransparent 

Note: The Ri, wi, and wix commands individually activate the tasks composing RWI and RWix. 

Example: 



f~^- 



J 



COMMAND {?): Wl 

Wl WRITE - NONTRANSPARENT 

WRITE ADDRESS? 5B 
WRITE RECL? 80 
NUMBER OF RECORDS? 10 
WRITE MONITOR? Y 



WIX — Write Transparent 

Note: The Ri, wi, and wix commands individually activate the tasks composing RWI and RWIX. 

Examp/e: 



COMMAND (?): WIX 

WIX WRITE - TRANSPARENT 

WRITE ADDRESS? 5B 
WRITE RECL? 80 
NUMBER OF RECORDS? 5 
WRITE MONITOR? Y 



(^^\ 

wy 



c 
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$CHANUT1 - Channel Attach Utility 



The $CHANUT1 utility starts or stops a channel attach device, enables or disables I/O tracing, 
and prints the trace area. $CHANUT1 issues prompts to the terminal where you loaded it; in 
response to a prompt, you must enter a command. 



Invoking $CHANUT1 



Invoke $CHANUT1 with the $L command or option 8.9 of the session manager. When you load 
$CHANUT1, it prompts you for the address of the channel attach device. 



> $L $CHANUT1 
ENTER DEVICE ADDRESS 
COMMAND(?): 



(Hex) 



10 



You can load the channel attach utility into any partition. The $chanuti commands interface 
with the channel attach program in the same manner as the channel attach instructions. The 
error codes for the $CHANUT1 commands are the same as those for the corresponding 
instructions. See Messages and Codes for more information. 



$CHANUT1 Commands 



To display the $CHANUTl commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



r 



COMMAND(?): 

CA -- 

EN -- 

PR -- 

ST -- 

SP -- 

TR — 
COMMANDC?): 



CHANGE DEVICE ADDRESS 
TERMINATE THE UTILITY 
PRINT THE TRACE AREA 
START A CHANNEL ATTACH DEVICE 
STOP A CHANNEL ATTACH DEVICE 
ENABLE/DISABLE TRACING 



y 



After SCHANUTl displays the commands, the system prompts you again with COMMAND (?):. 
Then you can respond with the command of your choice (for example, PR). Each command and 
its explanation is presented in alphabetical order on the following pages. 



CA — Change Device Address 

Use the CA command to change the device address. 



COMMAND(?): CA 
ENTER DEVICE ADDRESS 
COMMAND(?): 



(HEX) 



11 
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$CHANUT1 - Channel Attach UtWity {continued) 

EN — End $CHANUT1 utility 

Use the en command to end the $CHANUTl utility. 



Ky 



COMMAND(?): EN 
SCHANUTI ENDED AT ]:]k:kO 



PR — 



Print the Trace Area 

Use the PR command to print the trace buffer, with the title you enter, on a terminal. 



COMMAND(?): PR 

TITLE: TRACE PRINTOUT 07/26/80 

CONSOLE: $SYSPRTR 

PRINT TRACE BUFFER SUCCESSFUL 

COMMAND(?): 



SP — Stop a Channel Attach Device 



Use the SP command to stop the channel attach device you have specified. 



COMMAND(?): SP 

STOP DEVICE SUCCESSFUL 

COMMAND(?): 



\ y 



ST — Start a Channel Attach Device 



Use the st command to start the channel attach device you have selected. 



COMMAND(?): ST 

START DEVICE SUCCESSFUL 

COMMAND(?): 



TR — Enable/Disable Trace 



Use the tr command to enable (e) or disable (d) the trace function. 



COMMAND(?): TR 
ENABLE OR DISABLE: D 
ENABLE/DISABLE SUCCESSFUL 
COMMAND(?): 

V 



o 
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$CHANUT1 - Channel Attach Utility (continued) 



The following is an example of starting a trace using the session manager. 



$SMM08 SESSION MANAGER COMMUNICATION UTILITIES OPTION MENU 
ENTER/SELECT PARAMETERS: 



SELECT OPTION ==> 



1 - $BSCTRCE 

2 - $BSCUT1 

$BSCUT2 

$RJE2780 

$RJE3780 

$PRT2780 

$PRT3780 

$HCFUT1 

$CHANUT1 



(TRACE BSCAM LINES) 

(PRINT TRACE FILE) 

(BSC EXERCISER) 

(2780 RJE TO HOST) 

(3780 RJE TO HOST) 

(2780 SPOOLED RJE FILE PRINTER) 

(3780 SPOOLED RJE FILE PRINTER) 

(HOST COMMUNICATION FACILITY) 

(CHANNEL ATTACH UTILITY) 



WHEN ENTERING THESE UTILITIES, THE USER IS EXPECTED TO 
ENTER A COMMAND. IF A QUESTION MARK (?) IS ENTERED 
INSTEAD OF A COMMAND, THE USER WILL BE PRESENTED WITH 
A LIST OF AVAILABLE COMMANDS. 



The following shows what happens when you select option 9 (from the previous screen), request 
and start device 10, and enable trace. 



$CHANUT1 - INVOKED VIA SESSION MANAGER OPTION 8.9 

*"" JOB - $CHANUT1 - STARTED AT 00:00:00 00/00/00 """ 

JOB $CHANUT1 ($SMP0809) USERID=XXX 
$CHANUT1 21P, 00:00:00, LP= 9500 



ENTER DEVICE ADDRESS(Hex) 



10 



COMMAND(?): 
CAPGM 



ST 



45P,00:00:00, LP= AAOO 
START DEVICE SUCCESSFUL 
COMMAND(?): TR 
ENABLE OR DISABLE? E 
ENABLE/DISABLE SUCCESSFUL 
COMMAND(?): 
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$COMPRES - Compress Disk, Diskette, or Volume 

$COMPRES compresses a disk/diskette volume or the entire contents of a device. Used it to 
allocate new data sets and volumes when a volume or device is fragmented (due to deletion of 
data sets and volumes). 

Notes: 

1 . Do not compress a volume or device while it is being accessed. Use the $A ALL command to 
determine if programs are active in the partition you are currently assigned to or in other 
partitions. However, if you are executing under the session manager, the $SMUuser program 
will be in the system but not active until $C0MPRES ends. 

2. You must initialize the IPL text after using $compres if the device or the IPL volume you 
are compressing contains the supervisor ($edxnucx) and if the nucleus has moved. 

3. Before compressing the ipl volume, you should create an iPLable diskette as follows: 

a. Use $DASDI to format a diskette. 

b. Use $INITDSK (ID command) to initialize the diskette. Do not allocate a nucleus if your 
customized nucleus edxnucx is larger than 400 records. 

c. Copy (using $coPYUTi) $edxnucx, $loader and $initdsk to a backup ipl diskette. If 
a 4978 or 4980 terminal is your $syslog device, you need to do a "copy generic" (CG) 
for $4978 and $4980. You will need to use the "copy member" command (cm) of 
$MFARAM, $fpcaram, or $ACCARAM if you are using a 3101 or an ACCA device as L J 

$SYSLOG. 

d. Use the $initdsk ii command to initialize IPL text on the backup IPL diskette. 

e. Verify that you can ipl the diskette and load $initdsk to initialize IPL text on the IPL 
volume on disk before starting the $compres. 

4. If the compress moves the nucleus (as indicated by the message $edxnucx copied): 

a. IPL from the backup diskette. 

b. Initialize (write ipl text) the nucleus on disk using the ii command of $initdsk. 

c. IPL from the disk. 

5. If you have not copied $edxnucx, $loader, and $initdsk to a backup diskette and the 
compress does move the nucleus, you may use the starter system to load $initdsk (ii 
command) to initialize the IPL text. This assumes that one of the attached terminals will be 
recognized by the starter system as $syslog. 

6. Compressing a volume may relocate EDL overlay programs and data sets which you have 
defined previously to $prefind. If this is the case, you must reissue $prefind. 



(^ \ 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 

1. Compressing a disk may relocate volumes which you defined as "performance volumes." If 
this is the case, you must re-lPL. 

Specifying Dynamic Storage 

To increase program performance you can change the dynamic storage used by $compres. 
$COMPRES is shipped with a dynamic storage of 512 bytes. Using the $L command, you can 
specify the number of bytes of additional storage the system should allocate when $COMPRES is 
loaded for execution. 

The following example shows how to temporarily change a 512 byte Dynamic Storage 
Allocation to lOK. 



L 



> $L $COMPRES,, 10240 



You can use $diskut2 to modify the default load time storage allocation. See "SS — Set 
Program Storage Parameter" on page UT-219 for an example. 

Invoking $COMPRES 

Invoke $compres with the $L command or option 3.4 of the session manager. 

r 

> $L $COMPRES 
LOADING $COMPRES 37P ,08:00:00, LP = 5B00 

$C0MPRES - COMPRESS UTILITY 

VOLUME/DEVICE COMPRESS 

WARNING! SHOULD BE RUN ONLY WHEN 

NO OTHER PROGRAMS ARE ACTIVE 

COMMAND (?): ? 

ROLLON - SET SCREEN => NO PAUSE 

ROLLOFF - RESTORE STARTING CHARACTERISTICS 

D - DEVICE COMPRESS 

V - VOLUME COMPRESS 

HF - ESTIMATE COMPRESS PROGRESS 

EN - END 

COMMAND (?): 



$COMPRES Commands 

Each command and its explanation is presented in alphabetical order on the following pages. 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 



? — Help 



Use the ? command if you want to see the command menu again. 
Example: Help command. 



COMMAND (?) 



ROLLON - SET SCREEN => NO PAUSE 

ROLLOFF - RESTORE STARTING CHARACTERISTICS 

D - DEVICE COMPRESS 

V - VOLUME COMPRESS 

<ATTN> HF - ESTIMATE COMPRESS PROGRESS 

EN - END 



"A 



COMMAND (?) 



\..y 



\J 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 



D — Device Compress 



Use the D command to compress the entire contents of a device. Use $A all to determine if any 
programs are active before you compress the library. 

Example: Compress a Device with Fixed-Head Volumes. 



(Use $A ALL to determine if any programs are active 
before you compress the volume) 

COMMAND (?): D 
DEVICE ADDRESS: ^8 

COMPRESS DEVICE AT ADDRESS 0048 (Y/N)? Y 

DIRECTORY HAS BEEN SORTED BY MEMBER IN ASCENDING ORDER. 

THE FIXED-HEAD VOLUME ==> FIXVOL NOT COPIED 

EDX002 COPIED 

EDITWORK COPIED 

SRCLIB COPIED 

OBJLIB COPIED 

ASMLIB COPIED 

$COMPRES COPIED 

THE DEVICE IS COMPRESSED. 

ANOTHER COMPRESS? (Y/N)? N 



EN — End $COMPRES 

Use the EN command to end the $COMPRES utility. 
Example: End $COMPRES utility 

COMMAND (?): EN 
$COMPRES ENDED AT 08:03:59 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 

HF — Estimate Compress Progress 

Use >HF during a volume or device compress to get the percent of completion, the total number 
of records to be compressed, and the number already copied up to that point. To use this 
command, press the attention key and type in "HF". 



_/f~\ 



Example 7: Estimate progress of volume directory compress. 



> HF 



NOW AT: 70 PERCENT OF DIRECTORY LEFT TO BE SORTED 
TOTAL NUMBER OF RECORDS: 162 
NUMBER COPIED SO FAR : 49 



DIRECTORY SORTED 

DIRECTORY HAS BEEN SORTED BY LOCATION IN ASCENDING ORDER. 

$ASMOOOP ALREADY IN PLACE AND NOT COPIED 

$EDXATSR ALREADY IN PLACE AND NOT COPIED 

EDITINC ALREADY IN PLACE AND NOT COPIED 



CDRRCB COPIED 
HEADER COPIED 
TDBEQU COPIED 

V 



Example 2: Estimate progress of volume compress. 



> HF 



COMPRESSING THE VOLUME/DISK, NOW AT: 15 PERCENT 

$SPM COPIED 
COPCHECK COPIED 
$ASMEXIO COPIED 

> HF 
$ASMOOOH COPIED 



COMPRESSING THE VOLUME/DISK, NOW AT; 
CDRRCB COPIED 
HEADER COPIED 
TDBEQU COPIED 



17 PERCENT 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 



ROLLOFF — Restore Starting Characteristics 



Use the ROLLOFF command to restore a terminal to its original mode. With rolloff you must 
press enter each time the screen fills up. 

Example: Restore starting characteristics. 

COMMAND (?): ROLLOFF 
COMMAND (?): 



ROLLON — Set Screen => No Pause 



Use the ROLLON command if you don't want to have to press the enter key each time the screen 
fills up. When you specify this command, the output "rolls" off the top of the screen as new 
terminal output appears at the bottom of the screen. 

Example: Set screen to roll mode. 

COMMAND (?): ROLLON 
COMMAND (?): 






\^ 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 

V — Volume Compress 

Use the v command to compress a disk or diskette volume. Use $A all to determine if any 
programs are active before you compress the library. 

Example 1: Compress a Volume. 



tK 



> $A ALL 

PROGRAMS AT 08: 1^:19 

IN PARTITION #1 (STATIC) NONE 

PART.ADDR: 0000 HEX; SIZE: 12288 DEC. BYTES 

PROGRAMS AT 08:1^:19 

IN PARTITION #2 (DYNAMIC) 

$RMU 4700 TERMINAL 22 

CDR0V2 5200 
$DISKUT2 6F00 TERMINAL 15 

PART.ADDR: 4700 HEX; SIZE: 45056 DEC. BYTES 

PROGRAMS AT 08:l4:19 

IN PARTITION #3 (STATIC) NONE 

PART.ADDR: 0000 HEX; SIZE: 45056 DEC. BYTES 



PROGRAMS AT 08:14:19 

IN PARTITION #16 (DYNAMIC) NONE 

PART.ADDR: 0000 HEX; SIZE: 45056 DEC. BYTES 






> $L $COMPRES 
LOADING $COMPRES 



SCOMPRES 



37P, 08. 15.35, LP=4C00 
COMPRESS UTILITY 



VOLUME/DEVICE COMPRESS 

WARNING! SHOULD BE RUN ONLY WHEN 

NO OTHER PROGRAMS ARE ACTIVE 

COMMAND (?): y 
VOLUME LABEL = EDXOOl 

COMPRESS VOLUME EDXOOl (Y/N)? Y 

DIRECTORY HAS BEEN SORTED BY MEMBER IN ASCENDING ORDER 

MYPROG COPIED 
PR0G1 COPIED 
PR0G2 COPIED 
PAYROLL COPIED 
THE VOLUME IS COMPRESSED. 

ANOTHER COMPRESS (Y/N)? n 

WANT TO SORT VOLUME DIRECTORY (Y/N)? N 

$COMPRES ENDED AT 08. 16.03 
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$COMPRES - Compress Disk, Diskette, or Volume (continued) 



Example 2: Compress the IPL volume. 






(Use $A ALL to determine if any programs are 
active before you compress tine library) 



> $L $COMPRES 
LOADING $COMPRES 



$COMPRES 



37P, 08: 16:20, LP = CAOO 
COMPRESS UTILITY 



VOLUME/DEVICE COMPRESS 

WARNING! SHOULD BE RUN ONLY WHEN 

NO OTHER PROGRAMS ARE ACTIVE 

COMMAND (?): V 
VOLUME LABEL = EDX002 

COMPRESS VOLUME EDX002 (Y/N)? Y 

CAUTION: YOU ARE ABOUT TO COMPRES THE IPL VOLUME. 
IF THE NUCLEUS IS MOVED, THEN THIS VOLUME WILL NOT IPL 
AGAIN UNTIL THE "ll" COMMAND OF "$INITDSK" IS REISSUED. 
ALSO IF "$LOADER" IS MOVED, NO PROGRAMS CAN BE LOADED. 
DO YOU WISH TO PR0CEED(Y/N)? Y 

DIRECTORY HAS BEEN SORTED BY MEMBER IN ASCENDING ORDER. 



$edxnuc 


ALREADY IN PLACE AND NOT COPIED 


$LOADER 


COPIED 


$TERMUT1 


COPIED 


$C0PYUT1 


COPIED 


D3 


COPIED 


Dk 


COPIED 


D5 


COPIED 


D6 


COPIED 


D7 


COPIED 


D8 


COPIED 


D9 


COPIED 


DO 


COPIED 


$COMPRES 


COPIED 


THE VOLUME IS COMPRESSED. 



ANOTHER COMPRESS (Y/N)? N 

WANT TO SORT VOLUME DIRECTORY (Y/N)? N 

$COMPRES ENDED AT 08. 16.03 
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$COPY - Copy Data Set 



■:J 

$COPY copies a disk or diskette data set, in part or in its entirety, to another disk or diskette data 
set. 

Copying Programs or Data Members 

When copying volume members, the target member must already exist (allocate using $diskuti) 
and must be of the same organization as the source member. Two types of organization are 
available: 

DATA Data sets used as work files, user source modules, and application data set. 

When you copy data members, you may copy an entire member or only a 
selected number of records (partial copy). If you are copying the entire 
member, the target data member must be equal to or larger than the source. If 
you are doing a partial copy, the target member need not be as large as the 
source but must have enough space following the starting target record number 
to accommodate the number of records you are copying from the source 
member. 

PROGRAM Data sets that will contain executable (loadable) Event Driven Executive 
programs. 

When you copy program members, the target member must be equal to or 

greater than the source member. ^-^ 

Copying Disk/Diskette Volumes to Another Diskette/Disk "^ ^ 

When you copy a single volume diskette to disk, the target data set size must be equal to or 
greater than the diskette size in records. When you copy a disk volume or a multivolume 
diskette volume to another disk volume or a multivolume diskette, both volumes should be equal 
in size. If the source volume is larger than the target, you are prompted for the name of the 
source data set you wish copied to the target. The system copies the source data set to the 
target volume starting at the absolute beginning ($$edxvol). If the source volume is smaller 
than the target, you are prompted for the name of the target data set into which you want the 
source volume copied. 

Note: For information on copying H-exchange volumes see "$HXUT1 - H-Exchange Utility" 
onpageUT-371. 

Absolute Record Copy 

$COPY provides an absolute record capability using the special system data set names $$, 
$$EDXLIB, and $$EDXVOL. This allows you to copy a record relative to the beginning of a device 
($$edxvol) or relative to the beginning of a volume ($$edxlib). You can use this capability 
when you copy one single-volume diskette volume to another. The cv command of $COPY does 
not copy the first cyhnder on diskette. If the source diskette were an IPL volume (has IPL text 
and $EDXNUC), the system would not copy the ipl text, contained in the first record of the first 
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$COPY 

$COPY - Copy Data Set (continued) 

cylinder, to the target diskette. Therefore, the target diskette volume, although containing a 
supervisor in $edxnuc, would not be able to load that supervisor when you pressed the IPL key. 

To copy the IPL text to the target diskette, use the CD command with $$edxvol specified as the 
data set name and record 1 specified as the first and last record you want copied. 

Note: $$, $$EDXVOL, and $$edxlib are special system data set names and you must use them 
with care. $$ is a reserved system name, $$edxvol points to the beginning of the device 
volume, and $$edxlib points to the beginning of the data set directory within a volume. 

Specifying Dynamic Storage 

To increase program performance you can change the dynamic storage used by $C0PY. $COPY is 
shipped with a dynamic storage of 2K. Using the $L command, you can specify the number of 
bytes of additional storage the system should allocate when $C0PY is loaded for execution. 

The following example shows how to temporarily change a 2K Dynamic Storage Allocation to 
20K. 



^ 



> $L $COPY,,20A80 






$DiSKUT2.can also modify the default load time storage allocation associated with a program 
using the ss command. See "$DISKUT2 - Patch/Dump/List Data Set or Program" on page 
UT-198 for an example. 

Invoking $COPY 

You invoke $C0PY with the $L operator command or option 3.5 of the session manager. 

> $L $COPY 

LOADING $COPY 40P ,00: 12:04, LP= 9200, PART=1 

$C0PY - COPY UTILITY 

COMMAND (?): ? 
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$COPY - Copy Data Set (continued) 



$COPY Commands 



To display the $COPY commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



V 



COMMAND (?): ? 

CD - COPY DATA SET 

CV - COPY VOLUME 

RE - COPY FROM BASIC EXCHANGE 

WE - COPY TO BASIC EXCHANGE 

(-CA- WILL CANCEL) 
EN - END PROGRAM 
COMMAND (?): 



J 



After $COPY displays the commands, it prompts you again with COMMAND (?):. Then you can 
respond with the command of your choice (for example, CV). Each command and its 
explanation is presented in alphabetical order on the following pages. 



CD — Copy Data Set 



Use the CD command to copy disk or diskette data sets to a preallocated disk or diskette target 
data set. When you copy data sets, you may copy an entire data set or only a select number of 
records. If you are copying the entire data, the target data set must be equal to or larger than 
the source. If you do a partial copy, the target data set need not be as large as the source but 
should have enough space following the starting record number to accommodate the number of 
records you are copying from the source data set. 
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$COPY - Copy Data Set (continued) 



Example 1 : Copy entire data set. 



COMMAND (?): CD 

SOURCE ( NAME .VOLUME ) : ^ATAF I L 1 

COPY ENTIRE DATA SET? Y 

TARGET (NAME, VOLUME): DATAF I L2 .EDX002 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

50 RECORDS COPIED 

COMMAND {?): 






Notes: 

1 . You cannot copy data sets allocated as program organization to a data set that you allocated 
as data organization. 

2. When you copy program members, the target and source data sets must be equal in size. 
Example 2: Partial copy of a data set. 

COMMAND (?): CD 

SOURCE (NAME, VOLUME): DATAF I L 1 

COPY ENTIRE DATA SET? N 

FIRST RECORD: ^ 

LAST RECORD: 3 

TARGET (NAME, VOLUME): DATAF I L2 

FIRST RECORD: 1 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

3 RECORDS COPIED 

COMMAND (?): 



If the target data set is too small to accommodate the amount of data you are copying from the 
source data set, the utility issues following message: 



*^ 



TARGET DATA SET TOO SMALL 
COPY REQUEST CANCELLED "- 



J 



When the output data set is on disk or diskette, the system updates the end-of-data pointers. 
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$COPY - Copy Data Set (continued) 



ff^ 



CV — Copy Volume 



Use the cv command to copy entire volumes. This provides a volume backup capability. You 
may copy a disk volume to a disk or diskette volume, a diskette volume to a diskette volume, or 
a diskette volume to a preallocated disk data set of appropriate size in records. The number of 
records for the various types of diskettes are: 



Type 


128 Bytes/ 
sector 


256 Bytes/ 
sector 


1024 Bytes/ 
sector 


Diskette 1 


949 


1110 


_ 


Diskette 2 


1924 


2200 


- 


Diskette 2 D 


- 


3848 


4736 



Volume copy operations do not add the members in a source volume to the target volume. The 
system replaces the original contents of the target volume, including the directory. 

If you have two or more diskette units, you may perform diskette volume copies between 
diskette devices. If you have a single diskette drive and a disk, you can perform copies using the 
following procedure: 

1. Allocate a target data set on a disk of appropriate size. 

2. Using the CV command, copy the diskette volume to the disk data set. 

3. Mount the target diskette on the diskette device and vary the device online. 

4. Using the CV command, copy the contents of the disk data set to the target diskette. 

If you have a single 4966 Diskette Magazine Unit and a disk, the above procedure is also 
recommended. 

Example: Copy a diskette to a backup data set on a 4962 disk. 

COMMAND {?): CV 

COPY VOLUME 

ENTER SOURCE VOLUME: IBMEDX 
ENTER TARGET VOLUME: EDX002 
ENTER TARGET DATA SET NAME: DATAl 
ARE ALL PARAMETERS CORRECT? Y 
COPY COMPLETE 

949 RECORDS COPIED 

COMMAND (?): 






o 
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$COPY - Copy Data Set (continued) 

The cv command copies the entire single volume diskette volume. Therefore, the target data set 
should be equal to or greater than the volume size in records. If the target data set is not large 
enough, you may choose to do a partial copy or allocate (using $DlSKUTl) a target data set large 
enough to accommodate the source. 

Note: You can perform CV on an entire multivolume diskette. 

If the target data set is not large enough, you are prompted as follows: 

SOURCE DATA SET HAS nn RECORDS 

TARGET VOLUME HAS ONLY nn 

DO YOU WISH TO CONTINUE? (Y/N): 

If you respond v, the system copies the source to the target data set until the target is full. If 
you respond N, the cv command ends and you are prompted for another command, command 
(?):. 

Note: Once you have copied a volume to a target disk volume, the system replaces the original 
contents of the target volume, including the directory. As a result, you can no longer access the 
original contents of the target disk volume. 

EN — End $COPY Utility 

Use the EN command to end the $COPY utility. 

COMMAND {?): EN 
$COPY ENDED AT 1:1^:40 
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$COPY - Copy Data Set (continued) 



RE — Copy from Basic Exchange 



o 



Use the RE command to copy a basic-exchange data set from a diskette to a disk data set. A 
basic-exchange data set is contained on a diskette that you formatted for Standard for 
Information Interchange. You can use only one-sided, 128-byte diskettes as edx recognizes 
only one volume on a basic-exchange diskette. You must allocate the target disk data set using 
$DISKUT1 before you use the re command. 

RE prompts you for the source diskette data set name and volume, the target disk data set name 
and volume, the number of the first record you want written to the target data set, and the 
basic-exchange data set name. 

Example 1 : Copy entire basic-exchange diskette data set to disk. 

COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME): $$EDXVOL , I BMEDX 
TARGET (NAME, VOLUME): DATAF I L 1 ,EDX002 

SPECIFY START/END? (Y/N): N 

ENTER BASIC-EXCHANGE DATA SET NAME: 
NUMBER OF RECORDS COPIED: 52 
COPY COMPLETED 

COMMAND (?): 



Note: If you enter the wrong data set name, the system issues a read/write error message. 

Example 2: Copy basic-exchange data set to disk. The record number where the copy is to 
start on target disk is specified. 



DATA 



COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME): SSEDXVOL , I BMEDX 
TARGET (NAME, VOLUME): DATAF I L 1 ,EDX002 

SPECIFY START/END? Y/N: Y 
FIRST RECORD: 10 



ENTER BASIC-EXCHANGE DATA SET NAME 
NUMBER OF RECORDS COPIED: 151 
COPY COMPLETED 



DATA 



V. 



COMMAND (?): 



V ^ 
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$COPY - Copy Data Set (continued) 



WE — Copy to Basic Exchange 









Use the we command to copy a disk data set to a basic-exchange data set on diskette. You must 
allocate the diskette data set before you use the we command. Use $dasdi to format the 
diskette for Standard for Information Interchange. Under this format, $dasdi formats a volume 
called IBMEDX, initializes the basic-exchange header on the diskette, and automatically allocates 
a data set named data, data consists of all the data tracks on the diskette. 

WE prompts you for the source disk data set name and volume, the starting or ending records, 
the target diskette data set name and volume, and the basic-exchange data set name. 

Example 1 : Copy a disk data set to a basic-exchange diskette. 



COMMAND (?): WE 

SOURCE (NAME, VOLUME): DATAF I L 1 ,EDX002 

SPECIFY START/END? (Y/N): N 

TARGET ($$EDXVOL, VOLUME): SSEDXVOL , 1 BMEDX 



ENTER BASIC EXCHANGE DATA SET NAME: 
COPY COMPLETE 

COMMAND (?): 



DATA 



Example 2: Copy a disk data set to a basic-exchange diskette. The beginning and ending 
record numbers on the disk to be copied to the target diskette are specified. 



r 



COMMAND (?): WE 
SOURCE (NAME, VOLUME) 



SPECIFY START/END? (Y/N): 
FIRST RECORD: 100 
LAST RECORD: 150 
TARGET ($$EDXV0L, VOLUME): 



DATAF ILl ,EDX002 
Y 



ENTER BASIC-EXCHANGE DATA SET NAME: 
COPY COMPLETE 

COMMAND (?): 



SSEDXVOL, IBMEDX 
DATA 



Notes: 

1. Errors may occur if you have not initialized the diskette. The system reads and writes data 
on the diskette two sectors per I/O operation. 

2. The diskette data set you access must start on an odd sector boundary. 
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$COPYUT1 - Copy Data Set with Allocation 



$COPYUTl performs several related copy functions. These functions determine the size and 
organization of the source data set(s) that $copyuti copies, allocate members on the target 
volume, and then copy the source member(s) to the target member(s). With $copyuti, you can 
copy one member using the CM command or you can use the multiple copy commands to copy 
all members from source to target volumes. 

Notes: 

1. Do not specify the dynamic storage option (for example, $L $COPYUTl ,,48000) when 
loading $COPYUTl to make copies of the same volume from two or more terminals at the 
same time. This will cause formatting errors in your table of contents. 

2. If a member already exists on the target volume, it is first deleted, then reallocated when the 
new source is copied to the target volume. This occurs only if enough contiguous space is 
available for reallocation of the member. There are no prompting messages asking if you 
wish to replace the existing member. 

For any copying related to tape, see "$TAPEUT1 - Tape Management" on page UT-522. 



Specifying Dynamic Storage 



To increase program performance you can change the dynamic storage used by $copyuti. 
$COPYUTl is shipped with a dynamic storage of 2K. Using the $L command, you can specify the 
number of bytes of additional storage the system should allocate when $copyuti is loaded for 
execution. 

The following example shows how to temporarily change a 2K Dynamic Storage Allocation to 
20K. 



^~~\. 



I 



> $L SCOPYUTI ,,20^+80 



You can use $diskut2. to modify the default load time storage allocation See "SS — Set 
Program Storage Parameter" on page UT-219 for an example. 

Invoking $C0PYUT1 

Invoke $COPYUTi with the $L command or option 3.3 of the session manager. 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



> $L $C0PYUT1 
LOADING $C0PYUT1 59P ,00:01 : 5^, LP= 0000, PART= 2 

$C0PYUT1 - DATA SET COPY UTILITY 

*"* WARNING "** 
MEMBERS ON TARGET VOLUME WILL BE DELETED 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE 

THE DEFINED SOURCE VOLUME IS EDX002 OK (Y/N)? Y 
THE DEFINED TARGET VOLUME IS EDX002 OK (Y/N)? Y 
MEMBER WILL BE COPIED FROM EDX002 TO EDX002 OK (Y/N)? 

COMMAND (?): 



When you invoke SCOPYUTi, the source and target volumes are assumed to be on the IPL 
volume. You have the option of specifying the source and target volumes. Once you specify the 
correct volumes, the commands copy members from the source volume to the target volume 
until you change the volume using the cv command. 



$C0PYUT1 Commands 



o 



To display the $COPYUTl commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



COMMAND (?): ? 



A 



WV 

RDBK 

SQ 

NQ 

CV 

ROLLON 

ROLLOF 

CM 

CALL 

CAD 

CAP 

CG 

CNG 



MODE COMMANDS ====== 

-- VERIFY COPY USING WRITE VERIFY 
-- VERIFY COPY USING READBACK CHECK 
-- SET PROMPT MODE FOR COPY COMMANDS 
-- RESET PROMPT MODE FOR COPY COMMANDS 
-- CHANGE SOURCE AND TARGET VOLUMES 
-- SET SCREEN => NO PAUSE 
F -- RESTORE PAUSE CHARACTERISTICS 

COPY COMMANDS ====== 

-- COPY MEMBER FROM SOURCE TO TARGET 

-- COPY ALL MEMBERS FROM SOURCE TO TARGET 

-- COPY ALL DATA MEMBERS FROM SOURCE TO TARGET 

-- COPY ALL PROGRAMS FROM SOURCE TO TARGET 

-- COPY ALL MEMBERS STARTING WITH TEXT FROM ... 

-- COPY ALL MEMBERS NOT STARTING WITH TEXT FROM 



<ATTN> CA -- CANCEL MULTIPLE COPY COMMANDS 
EN -- END PROGRAM 
? -- HELP 

COMMAND (?): 



After $COPYUTi displays the commands, it prompts you with command (?): again. Then you 
can respond with the command of your choice (for example, cm). 



Chapter 4. Utilities UT-8 1 



$C0PYUT1 

$C0PYUT1 - Copy Data Set with Allocation (continued) 



The Mode Commands 



The following mode commands, presented in alphabetical order, modify the way the multiple 
copy commands (call, cad, cap, cg, cng) work. 

CV Changes the source and target volumes. 

NQ All members are copied. If you do not set SQ, the multiple copy command defaults 

toNQ. 

RDBK Does not use the hardware feature but actually reads the data back into storage to 

verify that it is valid. If you do not set RDBK, the multiple copy command you are 
using defaults to wv. 

ROLLOFF Turns off roll-screen mode. Then you must press the enter key each time the 
screen fills up. 

ROLLON Turns on roll-screen mode. In roll-screen mode, you do not need to press the 

enter key each time the screen fills up. Output "rolls" off the top of the screen as 
new terminal output appears at the bottom of the screen. 

SQ If you only want to copy some of the members, $COPYUTl asks you to verify each 

member before copying it. 

WV Forces a write verify of the target member by using the hardware feature available 

for validating the data written. WV is the default. 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 

Using the Copy Commands 

With the copy commands you can copy: 

• All or selected members in a volume 

• All or selected data type members in a volume 

• All or selected program types in a volume 

• All or selected members beginning with a generic text prefix 

• All or selected members that do not begin with a generic text prefix. 

If a copy command stops because the target volume on diskette is full, $copyuti issues the 
following message: 

DATA^t TOO LARGE TO COPY, ONLY XX RECORDS LEFT IN LIBRARY 
TARGET VOL IS FULL, DO YOU WISH TO CONTINUE ON A NEW VOL (Y/N)? 

If you wish to continue, enter a "Y"; $COPYUTl issues the following message: 



V. 



MOUNT NEW VOLUME AND DO AN ATTN SVARYON 
THEN ENTER ATTN RESTART TO CONTINUE COPY 



Mount a new volume, vary it online, and continue copying, as follows: 



'■ SVARYON 2 

EDXOOl ONLINE 
> RESTART 

V 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



/f % 



In this manner, you can create a disk backup spanning several diskettes. Although the copy may 
take longer using $copyuti instead of $movevol, you may use fewer diskettes as only members 
are copied. In addition, you can mix single- and double-sided diskettes. If you are creating a 
new volume, use $INITDSK (iv command) to start with an empty target volume. 

The copy commands will not copy the supervisor ($edxnuc). This prevents the inadvertent loss 
of a tailored supervisor. Furthermore, since the supervisor is allocated during disk initialization, 
the CM command will not allocate $edxnuc on the target volume. It will copy $edxnuc from 
source to target but only if you have allocated the target already and it is the same size as 
$EDXNUC on the source. 

The system does not allow absolute record copy from disk or diskette. Therefore, you cannot 
use the special names $$, $$edxlib, $$edxvol. The $copy utility provides an absolute copy by 
record number. 

To cancel a multiple copy command, press the attention key and enter CA. The command 
(call, cad, cap, CG, CNG) ends after the current member is copied. 

Note: When using the CAP, CAD, or call commands, you can specify the members you want to 
copy. If the starting member occurs later in the directory list than the ending member, the copy 
function wraps around and copies all members except those members that occur between the 
ranges specified. 

Each copy command and its explanation is presented in alphabetical order on the following 
pages. 



\J 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 

CAD — Copy All Data Members from Source to Target 

Use CAD to copy data sets designated as D (data) from the source volume to the target volumes. 
When you allocated data sets using $diskuti, you specified one of two organization types: D for 
data organization or p for program organization. Use data organization to specify data sets used 
as work files, user source modules, and application data sets. If you use the CAD command, 
$COPYUTl only copies those data sets you designated as D (data organization). 

You can copy all the data sets or specify a subset of data sets. If you reply Y to the COPY FROM 
BEGINNING? prompt, $COPYUTi copies all the data sets. If you respond N to the COPY from 
BEGINNING? prompt, $COPYUTl prompts you for the first (starting) member and the last (ending) 
member you want copied. 

Example: Copy only data sets designated as d from one volume to another. 

COMMAND(?): CAD 

COPY FROM BEGINNING? Y 

TEMP COPY COMPLETE kO RECORDS COPIED 

DATAFILE COPY COMPLETE 110 RECORDS COPIED 

MYDATA COPY COMPLETE 80 RECORDS COPIED 
COMMAND (?): 

CALL — Copy All Data Sets from Source to Target 

Use CALL to copy data sets from the source volume to the target volume. You can copy all the 
data sets or specify a subset of data sets. If you reply Y to the copy from beginning? prompt, 
SCOPYUTl copies all the data sets. If you respond n to the copy from beginning? prompt, 
$COPYUTi prompts you for the first (starting) member and the last (ending) member you want 
copied. 

When doing a call (copy all) function, $copyuti prints the names of the data sets it is 
copying. When the screen fills up, press the enter key to continue. By specifying the rollon 
command, you turn on roll-screen mode. In roll-screen mode, you do not need to press the 
enter key after the screen is full. Output "rolls" off the top of the screen as new terminal output 
appears at the bottom of the screen. You can turn off the roll-screen function by specifying the 
rolloff command. 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



Example 1 : Copy all data sets from one volume to another, starting with DATAl and ending 

with LASTONE. 



o 



> $L $C0PYUT1 
LOADING $C0PYUT1 



$C0PYUT1 



55P,1 1:16:57, LP= 69OO, PART=1 
DATA SET COPY UTILITY 



-- WARNING "** 
MEMBERS ON TARGET VOLUME WILL BE DELETED. 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE. 

THE DEFINED SOURCE VOLUME IS MYVOL , OK? Y 

THE DEFINED TARGET VOLUME IS MYVOL, OK? N 

ENTER NEW TARGET VOLUME: YOURVOL 

MEMBER WILL BE COPIED FROM MYVOL TO YOURVOL OK? 

COMMAND (?): ROLLON 

AUTO ROLL SCREEN MODE ON 

COMMAND (?): CALL 

COPY FROM BEGINNING? N 

ENTER STARTING MEMBER: DATAl 

COPY ALL THE MEMBERS AFTER DATAl? N 



ENTER ENDING MEMBER; 
DATAl COPY COMPLETE 
DATA2 COPY COMPLETE 



LASTONE COPY COMPLETE 
COMMAND (?): 



LASTONE 



256 RECORDS COPIED 
12 RECORDS COPIED 



1^ RECORDS COPIED 



\....> 



Example 2: Copy all data sets; SQ command prompts for copy of each data set. 



COMMAND(?): SQ 
COMMAND(?): CALL 

COPY FROM BEGINNING? Y 

COPY TEMP? Y 
TEMP COPY COMPLETE 
COPY EDITWORK? N 
COPY DATAFILE? Y 
DATAFILE COPY COMPLETE 
COMMAND (?): 



^0 RECORDS COPIED 



110 RECORDS COPIED 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



CAP — Copy All Programs from Source to Target 






Use CAP to copy programs from the source volume to the target volume. When you allocated 
data sets using $DISKUT1, you specified one of two organization types: D for data organization 
or P for program organization. Use program organization to specify data sets that contain 
executable (loadable) Event Driven Executive Language programs. If you use the cap 
command, $copyuti only copies those data sets you designated as P (program organization). 

You can copy all the data sets or specify a subset of data sets. If you reply Y to the COPY FROM 
BEGINNING? prompt, SCOPYUTi copies all the data sets. If you respond N to the copy from 
BEGINNING? prompt, $COPYUTl prompts you for the first (starting) member and the last (ending) 
member to be copied. 

Example: Copy only programs from one volume to another. 

COMMAND(?): CAP 

COPY FROM BEGINNING? Y 

PR0G1 COPY COMPLETE 40 RECORDS COPIED 

PR0G2 COPY COMPLETE 1 10 RECORDS COP I ED 

PR0G3 COPY COMPLETE 80 RECORDS COPIED 

LASTPROG COPY COMPLETE 60 RECORDS COPIED 
COMMAND (?): 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



CG — Copy All Members Starting with a Prefix 



Use the CG (copy generic) command to copy only those members beginning with generic text 
(prefix). $coPYUTi prompts you for the prefix. $copyuti then searches the source volume 
directory for names beginning with this prefix and copies only these members to the target 
volume. 

Example: Copy members with prefix of data. 



COMMAND (?): CG 

ENTER GENERIC TEXT: DATA 

DATAl COPY COMPLETE 

DATA2 COPY COMPLETE 

DATA3 COPY COMPLETE 



54 RECORDS COPIED 
13 RECORDS COPIED 
50 RECORDS COPIED 



DATA^t TOO LARGE TO COPY, ONLY 92 RECORDS LEFT IN LIBRARY 

TARGET VOLUME IS FULL, DO YOU WISH TO CONTINUE ON A NEW VOLUME (Y/N)? Y 

MOUNT NEW VOLUME AND DO A $VARYON 

THEN ENTER ATTN RESTART TO CONTINUE COPY 

> SVARYON 2 
EDX001 ONLINE 

> RESTART 



THE DEFINED TARGET VOLUME 
VOLUME NOT MOUNTED 
TRY AGAIN (Y/N)? Y 
ENTER NEW TARGET VOLUME: 
DATAA COPY COMPLETE 
COMMAND (?): 



IS ASMLIB, OK? Y 



EDXOOl 
100 RECORDS COPIED 






C J 



y 



CM — Copy Member from Source to Target 



Use CM to copy a member from the source volume to the target volume with the same 
characteristics. $C0PYUT1 automatically allocates the receiving merrtSer on the target volume. 



o 
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$C0PYUT1 - Copy Data Set with Allocation (continued) 



Example 1: Copy a data set (MYPROG) from EDX002 to asmlib and rename the data set SI, 



> $L $C0PYUT1 

LOADING $C0PYUT1 55P,n: 16:57, LP= 69OO, PART=1 

$C0PYUT1 - DATA SET COPY UTILITY 

** WARNING ** 
MEMBERS ON TARGET VOLUME WILL BE DELETED. 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE. 

THE DEFINED SOURCE VOLUME IS EDX002, OK ? Y 

THE DEFINED TARGET VOLUME IS EDX002, OK ? N 

ENTER NEW TARGET VOLUME: ASMLIB 

MEMBER WILL BE COPIED FROM EDX002 TO ASMLIB OK?: Y 

COMMAND (?): CM 

ENTER FROM( SOURCE) MEMBER: MYPROG 

ENTER TO (TARGET) MEMBER OR * FOR SAME NAME AS SOURCE: SI 

SI COPY COMPLETE k RECORDS COPIED 

COMMAND (?): 



CNG — Copy All Data Sets Not Starting with a Prefix 

Use CNG to copy only those data sets that do not begin with the prefix. $copyuti prompts you 
for a generic text prefix. $copyuti then searches the source volume directory for names that 
don't begin with the prefix and copies only those data sets to the target volume. 

Example: Copy data sets without a prefix of data. 



COMMAND (?): CNG 

ENTER GENERIC TEXT: DATA 
TEMPI COPY COMPLETE 
TEMP2 COPY COMPLETE 
TEMP3 COPY COMPLETE 

COMMAND {?): 



56 RECORDS COPIED 
15 RECORDS COPIED 
48 RECORDS COPIED 



EN — 



End $C0PYUT1 

Use EN to end the $COPYUTl utiUty. 

Example: End $COPYUTl. 

COMMAND (?): EN 

$C0PYUT1 ENDED AT 11:18:30 
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$DASDI - Format Disk or Diskette 



$DASDI initializes your disks and formats your diskettes. 

Invoking $DASDI 

You invoke $dasdi with the $L command or option 3.6 of the session manager. 

When you invoke $dasdi, it prompts you for one of the following primary initialization options: 

Primary Option - Create a Stand- Alone Dump/$TRAP Diskette 

Primary Option 1 - Diskette Initialization 

Primary Option 2 - 4962 Disk Initialization 

Primary Option 3 - 4963 Disk Initialization 

Primary Option 4 - 4967 Disk Initialization 

Primary Option 5 - DDSK Disk Initialization 

Primary Option 9 - Exit Initialization. 
Notes: 

1 . You can load $DASDI into any partition. $dasdi then loads the initialization routines, $14962, u J 
$14963, $14967, or $IDDSK30 into partition 1 , and $idskett into any available partition. 
$DASDI returns an error if partition 1 does not have the space for the initialization routines. 

2. When primary options 2, 3, 4, and 5 are executing, do not run a program that accesses the 
disk being initialized. 

3. You can run diskette initialization concurrently with other programs. 



\^ 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option — Create a Stand-Alone 

Dump/ STRAP Diskette Strap diskette Strap diskette strap, creating strap diskette 

Primary option uses a 4964, 4965, or 4966 diskette unit to initialize a two-sided, 
single-density, 256-byte diskette to be used for stand-alone dumps or the Strap utility. Sdasdi 
loads a program that places ipl text and the stand-alone dump utility on the front of the diskette. 
Once you create the diskette, it is ready for use. 

If you wish to dump more than 512K bytes, then you must create two diskettes for a stand-alone 
dump. Once you create them, these two diskettes are identical, and the order in which you use 
them is not important. 

The diskettes you have created are reusable and you do not have to re-create them after you 
have used them to take a stand-alone dump. 

Once you have obtained a stand-alone dump, you can list the contents of the diskette using 
SDUMP. To dump the contents of the diskette, use data set SSEdxlib and volume name ibmedx. 



^*%, 
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$DASDI - Format Disk or Diskette (continued) 



Primary Option Example: Create 2 diskettes for a stand-alone duinp >512K. 



> $L SDASDI 
LOADING $DASDI 



7P, 00: 34 -.11, LP= 9D00, PART=1 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 

2 = ^4962 DISK INITIALIZATION 

3 = '♦963 DISK INITIALIZATION 
k = 4967 DISK INITIALIZATION 
5 = DDSK DISK INITIALIZATION 
9 = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 

DO YOU WISH TO FORMAT 2 DISKETTES (Y/N)? Y 
DISKETTE TO BE FORMATTED FOR USE WITH: STAND-ALONE DUMP 
IS DISKETTE A 2-SIDED DISKETTE?: Y 

" DISKETTE FORMATTING PROGRAM * 

* IF FORMATTING IS IN PROGRESS, DO NOT " 

* CANCEL ($0 THIS PROGRAM. INSTEAD, PRESS * 

* ATTN AND ENTER $DASDI TO TERMINATE. " 

ENTER DISKETTE ADDRESS IN HEX: 02 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 02, STAND-ALONE DUMP FORMAT, SINGLE DENSITY, 256 BYTES/SECTOR 
WARNING : FORMATTING WILL DESTROY ALL DATA ON THE DISKETTE. 
CONTINUE (Y/N)? Y 
IBMEDX VARIED ONLINE 

FORMATTING COMPLETE 
STAND-ALONE DUMP DISKETTE BUILT 

*** REMOVE THE FIRST DISKETTE AND INSERT THE SECOND DISKETTE "** 
PRESS "ENTER" TO CONTINUE OR "PF3" TO EXIT OPTION 



\. 
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$DASDI - Format Disk or Diskette (continued) 



Create 2 diskettes for a stand-alone dump >512K (continued). 



1^ 



DISKETTE TO BE FORMATTED FOR USE WITH: STAND-ALONE DUMP 



" DISKETTE FORMATTING PROGRAM " 

* IF FORMATTING IS IN PROGRESS, DO NOT " 
" CANCEL ($C) THIS PROGRAM. INSTEAD, PRESS * 

* ATTN AND ENTER $DASDI TO TERMINATE. * 

jLxa.juxJUj«jLJua.JUJua.jujuxjujuxa*a>juxJUj.juXi..i<xjuJLJLa.a.j.jujujLJL.j*«!UJi.JLa.jua. 



ENTER DISKETTE ADDRESS IN HEX: 02 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 02, STAND-ALONE DUMP FORMAT, SINGLE DENSITY, 256 BYTES/SECTOR 
WARNING : FORMATTING WILL DESTROY ALL DATA ON THE DISKETTE. 
CONTINUE (Y/N)? Y 
IBMEDX VARIED ONLINE 

FORMATTING COMPLETE 
STAND-ALONE DUMP DISKETTE BUILT 

DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 
INITIALIZATION 
I N I T I AL I ZAT I ON 
INITIALIZATION 
INITIALIZATION 
INITIALIZATION 



2 = 4962 


DISK 


3 = 4963 


DISK 


k = 4967 


DISK 


5 = DDSK 


DISK 


9 = EXIT 


DISK 



V. 



ENTER DISK INITIALIZATION OPTION: 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 1 — Diskette Initialization 

The $DASDI utility initializes single and double-sided diskettes. Three formats are available: 

• Format for use with the Series/ 1 'Event Driven Executive 

• Format to the IBM Standard for Information Interchange 

• Format entire diskette to sector size: 128-, 256-, 512-, or 1024-byte records. 
Notes: 

1. Double-density is available on the 4965 and 4966 8 inch diskette units at 256, 512, or 1024 
bytes per sector. Only double-density at 256 and 1024 bytes per sector is recognized on the 
Event Driven Executive. 

2. 128 bytes per sector are available only at single density on the 8 inch diskette. 

3. 1024 bytes per sector are available only at double-density on the 8 inch diskette. 

The following matrix shows the configurations available by format for density and sector size 
when initializing your diskettes. 





128 bytes/sector 


256 bytes/sector 


512 bytes/sector 


1024 bytes/sector 


Formats 


S 


D 


S 


D 


S 


D 


S 


D 


Event Driven 
Executive 


Y 


N/A 


Y 


Y 


N/A 


N/A 


N/A 


Y 


Standard for 
Information 
Interchange 


Y 


N/A 


Y 


Y 


Y 


Y 


N/A 


Y 


Sector size 


Y 


N/A 


Y 


Y 


Y 


Y 


N/A 


Y 



Legend: 

S = Single-density (Disi<ette 1 and Diskette 2) 

D = Double-density (Diskette 2D on 4965 and 4966) 

Figure 10. Density and sector sizes available according to format 
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$DASDI 

$DASDI - Format Disk or Diskette (continued) 

Note: For basic exchange copying under the Standard for Information Interchange format, use 
a single-sided diskette, formatted as single density, 128 bytes per sector. For H-level exchange, 
use a double-sided diskette, formatted as double-density, 256 bytes per sector. 

Event Driven Executive Format 

If you select the Event Driven Executive format, cylinder is formatted according to the IBM 
Standard for Information Interchange. The remaining cyUnders are formatted at 128 or 256 
bytes per sector. On a 4965 and a 4966, a diskette may be formatted as double-density at 256 
or 1024 bytes per sector. 

After surface analysis is complete, $dasdi writes the volume label, ibmedx, on the diskette. The 
next step after preparing a diskette surface usually is to create a volume for use with the Event 
Driven Executive. You create volumes (establish directories) with the $initdsk utility. $dasdi 
gives you the option of going directly into $initdsk execution without having to end $dasdi and 
issue the $L command for $initdsk yourself. 

Standard for Information Interchange Format 

If you select the IBM Standard for Information Interchange, format cylinder according to that 
standard, and format the remaining cylinders for 128-, 256-, 5 12-, or 1024-byte records. 
$DASDI prompts you for the density (single or double) and the sector size (single: 1-128, 2-156, 
3-512; or double: 1-256, 2-512, 3-1024). If you are going to use the diskette for basic 
exchange copy under $C0PY, use a single-sided diskette formatted as single density, 128 bytes 
per sector. If you are going to use the diskette for H-exchange copy using $HXUT1, use a 
double-sided diskette formatted as double-density at 256 bytes per sector. After surface 
analysis, $DASDi writes the volume label, ibmedx, on the diskette and assigns a data set name, 
DATA. DATA consists of all the tracks on the diskette. Under this format, you do not need to 
initialize diskettes. 



Sector Size Format 



If you select the sector size format, $DASDI formats all cylinders to the density (single or double) 
and sector size you select (128, 256, 512, or 1024 bytes). After surface analysis, $dasdi does 
not write a volume label, header, or record in cylinder 0, and you are not given the option of 
going directly into $INITDSK execution. 

Note: A diskette initialized according to sector size cannot be used on an Event Driven system 
except for reformatting. 
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$DASDI - Format Disk or Diskette (continued) 



Operating Characteristics 



After you invoke $DASDI and choose primary option 1, $dasdi prompts you for the device 
address of the diskette drive where the diskette to be formatted is mounted. Enter this address 
in hexadecimal. 

Note: The 4966 has a capacity of 23 diskettes: 2 magazines of 10 diskettes each plus 3 slots for 
individual diskettes. The three individual slots are the first 3 slots in the device. $DASDI 
operates on diskettes in slot 1 only, you must mount in slot 1 any diskette on which you want to 
run surface preparation. 

After you choose a format, $DASDI prompts you (as constrained by format and device choice) 
for density (single or double) and sector size (128, 256, 512, or 1024 bytes). $dasdi varies the 
selected diskette device offline, displays the selected format, and issues the following warning 
message: 

■"""" WARNING ""*" 
FORMATTING WILL DESTROY ALL DATA 
ON THE DISKETTE. CONTINUE? 



If you respond Y, the following occurs for each of the three formats: 

1 . Event Driven Executive — $DASDI formats the diskette, writes a volume label (IBMEDX) on the 
diskette, and issues the message: 



I 



FORMATTING COMPLETE 



L 



You then have the option of going directly to $INITDSK as follows: 
LOAD $INITDSK? 



If you wish to create a logical volume or estabUsh a directory, respond Y and the system 
invokes $INITDSK. After you initialize your diskette under $initdsk, end the $initdsk utiUty. 

2. Standard for Information Interchange — $DASDI formats the diskette and writes a volume 
label (iBMEDx) on the diskette, allocates a data set called data, and issues the following 
message: 



L 



FORMATTING COMPLETE 



DATA consists of all the data tracks on the diskette. 



'\__J 



UT-96 SC34-0644 



^^Jjlplj' 



$DASDI 

$DASDI - Format Disk or Diskette (continued) 

3. Sector Size Format — $DASDI formats the diskette but does not write a volume label or header 
on the diskette; it issues the following message: 



CX 
/ 



I: 



FORMATTING COMPLETE 



$DASDI prompts you as follows: 



I 



ANOTHER DISKETTE? 



If you respond Y, you have the following choices (you should insert another diskette as 
required): 

Choice 1 



SAME DEVICE ADDRESS AND FORMAT? Y 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 22, EDX FORMAT, DOUBLE DENSITY. 256 BYTES/SECTOR 
FORMATTING WILL DESTROY ALL DATA ON THE DISKETTE IN SLOT 1. CONTINUE? 

V 

Or 
Choice 2 



SAME DEVICE ADDRESS AND FORMAT? N 
ENTER DISKETTE ADDRESS IN HEX: 



If you respond N to "ANOTHER DISKETTE," the system displays the $dasdi primary option 
menu again. 

Notes: 

1. Do not use $C to cancel a formatting operation. Enter ATTN $dasdi to force termination. 

2. After you create the volume label and data set header, the rest of cylinder consists of 
deleted records. Any attempt to read them results in an error condition. 
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$DASDI - Format Disk or Diskette (continued) 



Example 1 : Format a double-density diskette on a 4966 for Event Driven Executive. 



r 



$L $DASDI 
LOADING $DASOI 



7P, 00:28:55, LP= 7E00, PART=1 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 

2 = '♦962 DISK INITIALIZATION 

3 = k3kl DISK INITIALIZATION 
^4 = 4967 DISK INITIALIZATION 
5 = DDSK DISK INITIALIZATION 
9 = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 1 

DISKETTE INITIALIZATION 



La.JLJLJi..J.a.JLxjuji.j.j.a.Ji.j.j.j.J.j.xji.xj.J.JLj. 



DISKETTE FORMATTING PROGRAM 
IF FORMATTING IS IN PROGRESS, DO NOT 
CANCEL ($C) THIS PROGRAM. INSTEAD, PRESS 
ATTN AND ENTER $DASDI TO TERMINATE. 



^ 



ENTER DISKETTE ADDRESS IN HEX: 22 

ENTER it966 SLOT NUMBR (l, 2, 3): 1 

INITIALIZE FOR USAGE WITH THE IBM EVENT DRIVEN EXECUTIVE? (Y/N)? Y 

SELECT DENSITY (1=SINGLE, 2=D0UBLE): 2 
SELECT SECTOR SIZE (1=256, 2=1024): 1 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 22, EDX FORMAT, DOUBLE DENSITY, 256 BYTES/SECTOR 

"" WARNING "* 
FORMATTING DESTROYS ALL DATA ON THE DISKETTE IN SLOT 1. CONTINUE? Y 
IBMEDX VARIED ONLINE 

FORMATTING COMPLETE 
LOAD $INITDSK? N 

ANOTHER DISKETTE? N 






y 



\^ 
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$DASDI - Format Disk or Diskette (continued) 






r 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 

2 = ^962 DISK INITIALIZATION 

3 = ^963 DISK INITIALIZATION 
k = it967 DISK INITIALIZATION 
5 = DDSK DISK INITIALIZATION 
9 = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 9 

$DASDI ENDED AT 00:29:30 



Example 2: Format diskette on a 4964 to IBM Standard for Information Interchange. 

»* ' " " ■' I I 

ENTER DISKETTE ADDRESS IN HEX: 02 

INITIALIZE FOR USAGE WITH THE EVENT DRIVEN EXECUTIVE? N 

♦ 

INITIALIZE TO IBM STANDARDS FOR INFORMATION INTERCHANGE? Y 

NOTE: EDX SUPPORT FOR IBM STANDARDS FOR INFORMATION INTERCHANGE 

DISKETTES IS LIMITED TO THE DOCUMENTED EDX EXCHANGE UTILITIES 
SELECT SECTOR SIZE (1=128, 2=256, 3=512): 1 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 02, IBM STANDARD FORMAT, SINGLE DENSITY, 128 BYTES/SECTOR 

CONTINUE? Y 



"^ 



"" WARNING «* 
FORMATTING WILL DESTROY ALL DATA ON THE DISKETTE 
IBMEDX VARIED ONLINE 



FORMATTING COMPLETE 
ANOTHER DISKETTE? N 
$DASDI ENDED AT 00:44:30 
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$DASDI - Format Disk or Diskette (continued) 



Example 3: Format diskette on a 4966 to 256-byte records (double-density). 



r 



ENTER DISKETTE ADDRESS IN HEX: 22 

INITIALIZE FOR USAGE WITH THE EVENT DRIVEN EXECUTIVE? N 

INITIALIZE TO STANDARDS FOR INFORMATION INTERCHANGE? N 
SELECT DENSITY (l=SINGLE, 2=D0UBLE): 2 
SELECT SECTOR SIZE (1=256, 2=512, 3=102A): 1 
DEVICE VARIED OFFLINE 

DEVICE ADDRESS 22, NONSTANDARD, DOUBLE DENSITY, 256 BYTES/SECTOR 

"" WARNING "" 
FORMATTING WILL DESTROY ALL DATA ON THE DISKETTE IN SLOT 1. CONTINUE? 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 2 — 4962 Disk Initialization 

The disk initialization utility for the 4962 initializes your disk, writes sector addresses on the 
entire volume, analyzes and locates defective sectors, and assigns alternate sectors. After you 
initialize the disk, it is ready for use with the Event Driven Executive. For a new disk device, 
you should perform initiahzation before you install the Event Driven Executive on it. 

When using this primary option, you must select one of two initialization types: 

• PI (primary) — initiaUze a disk for the first time or completely reinitiaUze the disk. 

Note: This type rewrites the complete disk surface and destroys all data that may have been 
on the disk. 

• AS (alternate sector assignment) — assign alternate sectors without destroying the data 
currently on the disk. 

Using PI Initialization 

Use PI to verify and correct sector ids and to analyze the disk surface to find defective sectors. 
If the programmer's console is active, the data buffer displays the number of the cylinder $dasdi 
is initializing currently. If the system finds a defective sector, either on a movable or a fixed 
head, it assigns an alternate sector from cylinder 1 and $dasdi issues a message. When the 
system assigns an alternate sector, the sector id of the defective sector refers to the location of 
its alternate on cylinder 1 . The system marks defective sectors. If a defective sector exists on 
cylinder 0, the system assigns to the defective sector an alternate sector under the same head on 
cylinder 0. 

Using AS Initialization 

Use AS to force the assignment of alternate sectors without destruction of data on the disk. 
$DASDI tries to move data from the defective sector to its assigned alternate. If data recovery 
fails, $DASDI issues a message and flags the alternate data field with all one-bits (hexadecimal 
ffff). If the system finds an assigned alternate is defective, it marks the alternate as defective 
and assigns a new alternate. The system attempts data recovery in this case, also. 

Note: Use as only when necessary. Cylinder 1 has a limited number of available alternate 
sectors. Once the system assigns an alternate sector, you can recover the sector only by writing 
all sector ids during a primary initiahzation. 
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$DASDI - Format Disk or Diskette (continued) 



The storage capacity and number of alternate sectors available on cylinder 1 depends on the 
4962 model: 





Storage capacity (in bytes) 


)■ 


Alternate 


Model 


Moveable heads 


fixed heads 


sectors 


1 


9,308,160 




120 


IF 


9,308,160 


122,880 


120 


2 


9,308,160 


- 


120 


2F 


9,308,160 


122,880 


120 


3 


13,962,240 


- 


180 


4 


13,962,240 


- 


180 



Example 1 : Primary initialization of a 4962 disk. 



> $L SDASDI 

LOADING SDASDI 7P, 00:28:55, LP=7E00, PART=1 

DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 



= 

1 = 

2 = 

3 = 
h = 
5 = 
9 = 

ENTER 



CREATE STAND-ALONE DUMP/$TRAP DISKETTE 
DISKETTE INITIALIZATION 

DISK INITIALIZATION 

DISK INITIALIZATION 

DISK INITIALIZATION 

DISK INITIALIZATION 

DISK INITIALIZATION 



4962 
4963 
4967 
DDSK 
EXIT 
DISK 



INITIALIZATION OPTION; 



\^ 



4962 DISK INITIALIZATION 



WARNING 
NO USER PROGRAM SHOULD BE RUNNING 
WHILE PERFORMING DISK INITIALIZATION 



. JU J.X JL J- 



DISK INITIALIZATION STARTED 

ENTER DISK DEVICE ADDRESS-NN (HEX) 

03 



ENTER INITIALIZATION TYPE 

PI 



PI OR AS; 



ENTER INITIALIZATION MODE 

REMOVE PREVIOUS ... DEFECTIVE SECTOR FLAGS? Y/N: N 
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$DASDI - Format Disk or Diskette (continued) 

In the previous example, $DASDI prompts for the following: 

• Disk or diskette primary initialization option: 1 through 6 

• Initialization type: PI for primary or as for alternate sector 

• Initialization mode: 

— N - Retain defective flag byte of each sector id. 

— Y - Rewrite sector flag IDs and reinitialize the flag byte where possible. Allows you to 
initiaUze a disk with invalid sector flags. 

Note: Respond Y only if you wish to rewrite all sector ids. This causes the loss of any IBM 
factory-assigned defective sector flags. If you respond Y, the following verify operation occurs: 

FACTORY-MARKED DEFECTIVES MAY BE LOST 
IS CHANGE OF REPLY DESIRED? Y/N: N 



C^, 



N Operation will continue with flags considered invalid. 

Y A reprompt of the previous message results, allowing you to change the status of the 
defective flags. 

The system repeats the following message for each alternate sector assignment, if any occurs: 



I 



ALTERNATE SECTOR ASSIGNED FOR ccchss 



Note: ccchss = the address of the alternate sector assigned. 
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$DASDI - Format Disk or Diskette (continued) 



"~%i 



Example 2: Alternate sector assignment on a 4962 disk. 



v. 



> $L $DASDI 






, LP=7E00 




LOADING 


$DASDI 


7P, 00:28:55 


, PART=1 


DIRECT 


'XCCESJ 


; DEVICE INITIALIZATION 




DISK 


INITIALIZATION OPTIONS: 




= 


CREAl 
DISKE 


■E STAND-ALONE DUf 


■1P/$TRAP I 
)N 


)ISKETTE 


1 = 


:tte 


NITIALIZATK 




2 = 


^962 


DISK 


INITIALIZATION 




3 = 


^963 


DISK 


INITIALIZAT 


ON 




k = 


4967 


DISK 


INITIALIZAT 


ON 




5 = 


DDSK 


DISK 


INITIALIZAT 


ON 




9 = 


EXIT 


DISK 


INITIALIZAT 


ON 




ENTER 


DISK 


INITIALIZATION OPTION: 2 





4962 DISK INITIALIZATION 



WARNING 
NO USER PROGRAM SHOULD BE RUNNING 
WHILE PERFORMING DISK INITIALIZATION 



DISK INITIALIZATION STARTED 

ENTER DISK DEVICE ADDRESS - NN (HEX); 

03 

ENTER INITIALIZATION TYPE - PI OR AS; 
AS 



ALTERNATE SECTOR MODE 
ENTER SECTOR ADDRESS ■ 



CCCHSS 






Cylinder /Head /Sect or (ccchss): The address of tlie sector presumed to be defective. 
$DASDI assigns an alternate sector on cylinder 1 then tries to move the data from the defective 
sector to the alternate sector. Alternates on cylinder are located on the same track and head 
as the defects on cylinder 0. This process may reveal that the sector ids on cylinder are in an 
inconsistent condition. Processing continues if possible. You cannot assign an alternate to a 
defective sector on cylinder 1 . 

Note: The system always refers to the fixed-head area as cylinder 303. You should consider 
that this cyUnder contains eight heads (zero through seven). To refer to sector five under 
fixed-head four, specify 303405. 



The system displays the following message at your terminal indicating completion of the disk 
initialization. 



ALTERNATE SECTOR ASSIGNED FOR CCCHSS 
DISK INITIALIZATION COMPLETE 



V. 



$DASDI ENDED AT 00:31:15 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 3 — 4963 Disk Initialization 

The $DASDI utility identifies and restores defective sectors on a 4963 disk device. The 4963 
comes from the factory already formatted with all logical sector addresses assigned and tested 
and with alternates assigned to any defective sectors; you do not have to initiaUze a newly 
installed 4963. 

With this primary option, you can: 

• Identify a specific sector as being defective and cause the utiUty to assign an alternate to it. 

• Restore a previously identified defective sector and cause the utility to free its alternate. 

• Print a map of all defective sectors and indicate if the defective sector were factory- or 
user-identified. 

The system assigns alternate sectors as follows: 

• If the primary alternate (the extra sector on the same track) is available, the system uses it as 
the alternate for the defective sector. 

• If the primary alternate is not available (either it is defective or already assigned), the system 
assigns a secondary alternate from the nearest track under the movable heads having an 
available primary alternate. 

Note: The system assigns the primary alternate under a fixed head to a sector that is under the 
same fixed head. 

The storage capacity and the number of alternate sectors for each 4963 model follows: 



Model 


Storage 
capacity (in bytes) 


Alternate 
sectors 


Moveable head: 

23A,B 
29 A, B 
58A,B 
64A,B 


23,592,960 
29,491,200 
58,982,400 
64,880,640 


358 
358 
358 
358 


Fixed-head: 

23A, 23 B, 
58A, 58B only 


131,072 


358 
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$DASDI - Format Disk or Diskette (continued) 

When restoring sectors from defective status, $dasdi physically moves the sectors within the 
track to minimize the processing time between consecutive logical sectors. You cannot restore: 



• A factory-assigned defective sector 

• A primary defect (one that causes the system to assign the primary alternate for the track) 

• A sector whose id has been extended (caused by a defect in the ID field of the original 
sector). (See example 2 on the following page.) 



Example 1 : Invoking 4963 disk initialization. 



> $L $DASDI 
LOADING $DASDI 



7P, 00:28:55, LP=7E00, PART=1 



'^ 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 

2 = 4962 DISK INITIALIZATION 

3 = 4963 DISK INITIALIZATION 
k = 4967 DISK INITIALIZATION 
5 = DDSK DISK INITIALIZATION 
9 = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 3 

4963 DISK INITIALIZATION 

" WARNING ' 

" NO USER PROGRAM SHOULD BE RUNNING ' 

" WHILE PERFORMING DISK INITIALIZATION ' 



DISK INITIALIZATION STARTED 

ENTER DISK DEVICE ADDRESS-NN (HEX) 

48 

THE AVAILABLE OPTIONS ARE: 

1 - IDENTIFY DEFECTIVE SECTOR(S) 

2 - RESTORE DEFECTIVE SECTOR{S) 

3 - MAP DEFECTIVE SECTOR(S) 

4 - EXIT UTILITY 

ENTER OPTION: 



Your option entry must be one of the four secondary options Usted in the command menu. You 
can choose to identify, restore, or map defective sectors. $DASDI ends when you enter primary 
option 9. 



m # 
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$DASDI - Format Disk or Diskette (continued) 



Example 2: Obtaining a map of defective 4963 sectors. 

ENTER OPTION: 
3 



DEFECT 
0000101 
0020114 
03^0401 



ALTERNATE 



3580400 



EXTENDED 



This map shows three defective sectors, one of which is a secondary defect (indicated by the 
alternate address). If the system finds a defective id and is able to extend that sector to an 
alternate one, the map displays an asterisk (*) in the extended field for that sector. 

Example 3: Assigning an alternate sector. 



ENTER OPTION: 

1 

ENTER CCCHHSS OF SECTOR TO BE MARKED DEFECTIVE OR END: 
0010205 

ENTER 'Y' TO ASSIGN ALTERNATE, ANYTHING ELSE TO CANCEL; 
Y 

3580101 ASSIGNED ALTERNATE OF 0010205 

ENTER CCCHHSS OF SECTOR TO BE MARKED DEFECTIVE OR END: 

END 

ENTER OPTION: 
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$DASDI - Format Disk or Diskette (continued) 



/f^\ 



Notes: 

1. In the preceding example, enter the disk address for a 4963 as a seven-digit number 
(0010205): the cylinder is 1 (001), the head is 2 (02), and the sector is 5 (05). 



2. $DASDi uses the following range of values for the ccchhss of a 4963; 



cylinder - 357 

head 0-4(5,10,11)* 

sector 0-63 

depending on model 



3. $DASDi may appear to assign an alternate for a ccchhss that is not the one you specified. 
This occurs because the 4963 is arranged as follows: 



records 0,32 are located in physical sector 
records 1,33 are located in physical sector 1 



records 31,63 are located in physical sector 31 



Example 4: Restoring a previously assigned alternate sector. 



V. 



ENTER OPTION: 
2 

ENTER CCCHHSS OF SECTOR TO BE RESTORED OR END; 
0010207 

0010207 HAS BEEN RESTORED FROM ccchhss 

ENTER CCCHHSS OF SECTOR TO BE RESTORED OR END: 
END 

ENTER OPTION: ^ 

DISK INITIALIZATION ENDED 

$14963 ENDED AT 01:01:27 



^ V 



Note: The system always refers to the fixed-head area on the 4963 as cylinder 511. This 
cylinder contains 8 heads (16-2^) and 64 sectors (0-63). 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 4 — 4967 Disk Initialization 

The $DASDI utility identifies and restores defective sectors on a 4967 disk device. However, 
unlike the 4962 and 4963 disks, the system identifies the sector addresses on the 4967 by 
relative block address (rba) rather than by cylinder, track, and sector. 

With primary option 4, you can: 

Verify all data fields and associated ids on the entire disk or a selected cylinder and identify 
any defective rbas. 

Refresh data associated with a specified RBA. 

Assign an alternate sector for a specified RBA. 

List the assigned alternate sectors. 

Remove an alternate sector assignment. 

Write one sector id. 

The storage capacity and the number of alternate sectors for each 4967 model follows: 






Model 



Storage 
capacity (in bytes) 



Alternate 
sectors 



02CA 
02CB 



200,177,152 
200,177,152 



7,966 
7,966 



Chapter 4. Utilities UT- 1 09 



$DASDI 

$DASDI - Format Disk or Diskette (continued) 



Example 1: Invoking 4967 disk initialization. 



> $L $DASD1 
LOADING $OASDI 



7P, 00:28:55, LP«7E00, PART=1 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

= DISKETTE INITIALIZATION 

= ^962 DISK INITIALIZATION 

= 4963 DISK INITIALIZATION 

= 4967 DISK INITIALIZATION 

= DDSK DISK INITIALIZATION 

* EXIT DISK INITIALIZATION 




1 
2 
3 

it 

5 

9 

ENTER 



DISK INITIALIZATION OPTION: k 



4967 DISK INITIALIZATION 

" WARNING ^ 

" NO USER PROGRAM SHOULD BE RUNNING * 

DISK INITIALIZATION STARTED 
ENTER DEVICE ADDRESS-NN (HEX): 
072 

THE AVAILABLE OPTIONS ARE: 

- VERIFY ENTIRE DISK 

1 - VERIFY CYLINDER BY SELECTED RBA 

2 - REFRESH DATA 

3 - ASSIGN ALTERNATE SECTOR 

4 - REMOVE ALTERNATE SECTOR ASSIGNMENT 

5 - LIST ALL USER ASSIGNED ALTERNATES 

6 - WRITE ONE SECTOR ID 

7 - EXIT 

ENTER OPTION: 






Your option entry must be one of the seven secondary options listed in the command menu. 
Primary option 4 ends when you enter secondary option 7. Once you return to the primary 
menu, $dasdi ends when you enter primary option 9. 
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Secondary Option — Verify Entire Disk 

Use secondary option to identify any defective RBAs on the entire 4967 disk. The system 
reads and verifies all data fields and associated sector IDs on the disk. If it finds no errors, 
$DASDI issues the following message: 



'^ 



ENTER OPTION: 

FILE BEING VERIFIED, ID'S AND DATA 

NO SECTOR OR DATA ERRORS 






^l^i,# 



When you use secondary option 0, no errors are expected to occur. However, if the system 
detects errors, you should correct them. 

If the system detects errors, $dasdi displays a table showing the relative block address, the 
sector ID of the rba, the head and cylinder, and a comment describing the error. Following the 
table, $DASDi displays the recommended ways to correct the errors. 



RBA 



ID-FG/SEC 



HD/CYL 



PHY/BSD 



^ 



00000 


1000 


Oi»00 


03FF NRF-ID NOT VALID 


002AE 


1000 


Oi»00 


03FF NRF-ID NOT VALID 


BEED9 


0001 


063A 


03FF DATA ERROR 


BEEDA 


0002 


0A3A 


03FF SOFT ERR-ECC CORRECTED 


BEED8 


0000 


023A 


03FF DATA ERR-ECC INVERTED 


BEEDB 


BBBB 


BBBB 


BBBB NRF- ID NOT READABLE 


BEEDC 


OOOi* 


9999 


03FF NRF- ID NOT VALID 


BEEDD 


0006 


163A 


03FF SOFT ERROR RETRY 


BFI89 


B6BB 


BBBB 


BBBB NRF- ID NOT READABLE 


BF18A 


BBBB 


BBBB 


BBBB NRF- ID NOT READABLE 



*v. 



UNREADABLE ID- ASSIGN AN ALTERNATE- USE ONLY ONE RBA PER SECTOR 
DATA ERROR- REFRESH RECORD (OPTION 2). IF ERROR 

PERSISTS, ASSIGN AN ALTERNATE. 

SOFT ERROR- ECC CORRECT- REFRESH RECORD (OPTION 2). 

IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 
ECC INVERTED- REFRESH RECORD (OPTION 2). 

IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 
INVALID ID- WRITE SECTOR ID (OPTION 6). 
WILL BE RECOVERED. 



IF POSSIBLE, DATA 



This table shows flagged or bad sectors that exist on the disk. 

Note: Use of secondary option causes all system processing to stop until secondary option 
completes. This option takes approximately 6 minutes to complete since it is reading and writing 
every sector on the entire disk. 

If you suspect you have a defective rba (as indicated by disk error messages), you may want to 
look at your $syslog (cycle steal status) to find which rba is causing the disk errors. If you do 
this, then use secondary option 1 to verify that particular rba. 
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$DASDI - Format Disk or Diskette (continued) 

Secondary Option 1 — Verify a Cylinder by Selected RBA 

Use secondary option 1 to identify defective RBAs on a particular cylinder. The system reads 
and verifies all data fields and associated IDs on the selected cylinder. If it finds no errors, 
$DASDI issues the following message: 






ENTER OPTION: 1 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 

NO SECTOR OR DATA ERRORS 



DIGITS (RRRRR): 123^5 



If $DASDi finds an error, it displays a table showing the relative block address, the sector ID of 
the RBA, the head and cylinder, and a comment describing the error. Following the table, 
$DASDI displays the recommended ways to correct the errors. 



r 



RBA 



ID-FG/SEC 



00000 


1000 


002AE 


1000 


BEED9 


0001 


BEEDA 


0002 


BEED8 


0000 


BEEDB 


BBBB 


BEEDC 


OOO^t 


BEEDD 


0006 


BF189 


BBBB 


BF18A 


BBBB 



HD/CYL PHY/BSD 

0400 03FF NRF-ID NOT VALID 

0^00 03FF NRF-ID NOT VALID 

063A 03FF DATA ERROR 

0A3A 03FF SOFT ERR-ECC CORRECTED 

023A 03FF DATA ERR-ECC INVERTED 

BBBB BBBB NRF- ID NOT READABLE 

9999 03FF NRF- ID NOT VALID 

163A 03FF SOFT ERROR RETRY 

BBBB BBBB NRF- ID NOT READABLE 

BBBB BBBB NRF- ID NOT READABLE 



USE ONLY ONE RBA PER SECTOR 
F ERROR 



UNREADABLE ID- ASSIGN AN ALTERNATE 

DATA ERROR- REFRESH RECORD (OPTION 2). 

PERSISTS, ASSIGN AN ALTERNATE. 

SOFT ERROR- ECC CORRECT- REFRESH RECORD (OPTION 2) 

IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 
ECC INVERTED- REFRESH RECORD (OPTION 2). 

IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 
INVALID ID- WRITE SECTOR ID (OPTION 6). 
WILL BE RECOVERED. 



IF POSSIBLE, DATA 



\y 



This table shows flagged or bad sectors that exist on a selected cylinder. 
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$DASDf - Format Disk or Diskette (continued) 



Secondary Option 2 — Refresh Data 



Use secondary option 2 to refresh the data contained in the sector to ensure that it is valid or 
correct. You are able to patch data in the suspected rba and write the new data back out to the 
RBA. If the error no longer appears, you can use the RBA as is. If the error still appears, then 
you must assign an alternate sector (secondary option 3). 

Notes: 

1 . For inverted ECC errors, if you write back the RBA without correcting it, the inverted ECC 
error disappear. However, the data could still be bad. Be sure to verify the data. 

2. For ECC corrected errors, you need not verify the data before writing it back to disk. 
Example: 

I ENTER OPTION: 2 

I ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123^5 

At this point, $dasdi reads the selected RBA and displays the 256 bytes, in eight- words-per-line 
format, contained in the rba. 

D368: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D378: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D388: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D398: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3A8: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3B8: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3C8: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3D8: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3E8: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

D3F8: 0000 23AB 0000 23AB 0000 23AB 0000 23A8 

F408: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 

F^18: 0000 23AB 0000 23AB 0000 23AB 0000 23AB 



V. 



$DASDI then prompts you as follows: 



I 



PATCH THE RBA IN STORAGE? 



If you enter Y, $DASDi issues a prompt for the starting address and number of words (count) of 
the patch: 



U 



ENTER THE ADDRESS .COUNT: D368,l 
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$DASDI - Format Disk or Diskette (continued) 



$DASDI then displays the address of the area you want to patch and the data currently appearing 
at that location. Enter the new data. 



o 



I 



0368:0000 
DATA: FFFF 



$DASDI displays the selected rba showing the selected address and changed data. 



r 



D368 
D378 
D388 
D398 
D3A8 
D3B8 
D3C8 
D308 
D3E8 
03F8 
F408 
F418 



FFFF 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 
23AB 



$DASDI then prompts if you wish to patch another location in the same RBA. 
I PATCH THE RBA IN STORAGE? N 

If you respond Y, $dasdi prompts for another address and count. If you respond N, $dasdi 
issues a prompt asking if you wish to write the changed rba to disk. If you respond Y to this 
prompt, $DASDI writes the changed rba back to the disk. 



o 



WRITE THE RBA TO DISK? 
DATA RECORD WRITTEN 



Once you have written the rba to disk, $dasdi issues a prompt asking if you wish to patch 
another area. 



I 



ANOTHER PATCH? Y/N 



If you respond Y, $dasdi again prompts for the selected RBA and displays the 256 bytes 
contained in that rba in eight-word-per-Une format. If you respond N, $DASDI returns to the 
4967 Disk Initialization secondary menu. 



% m 
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$DASDI - Format Disk or Diskette (continued) 

Secondary Option 3 — Assign Alternate Sector 

Use secondary option 3 to assign an alternate sector for a selected rba. 

Example: 



ENTER OPTION: 3 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123^5 

ALTERNATE ASSIGNED 



Secondary Option 4 — Remove Alternate Sector Assignment 

Use secondary option 4 to remove an alternate sector assignment that you assigned using 
secondary option 3. 

Example: 



ENTER OPTION: ^ 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123^5 

ALTERNATE UNASSIGNED 






If the RBA you specified is not assigned to an alternate sector, $DASDI issues the following 
prompt: 



USER DEFECT NOT FOUND 

ALTERNATE UNASSIGNMENT NOT COMPLETED 



Secondary Option 5 — List All User-Assigned Sectors 

Use secondary option 5 to display a list of alternate sectors you assigned. 

Example: 

ENTER OPTION: 5 

DISK BEING SEARCHED FOR USER DEFECTS 

USER ASSIGNED DEFECTIVE SECTORS 

RBA RBA tD=FG/SEC HD/CYL PHY/BSD 
123'*5 125F3 1100 0^436 3BFF 
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$DASDI - Format Disk or Diskette (continued) 



Secondary Option 6 — Write One Sector ID 

Use secondary option 6 to convert the selected rba to a head, cylinder, and logical number. 
The system writes the sector id for that logical number using the factory defect data (if any 
exist) from the surface analysis cylinder. The system recovers and writes data with the sector ID. 

Example: 



ENTER OPTION: 6 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123^5 

SECTOR ID WRITTEN 



If the system has already assigned the selected rba as a user-defined alternate, then $DASDI 
displays the following message: 



L 



USER-ASSIGNED ALTERNATE SELECTED, ID WILL NOT BE WRITTEN. 



J 



If you specify the surface analysis cyUnder, then the following message is displayed: 



SURFACE ANALYSIS CYLINDER SPECIFIED 
ID/ID'S NOT WRITTEN 



If the system detects an error while recovering data, it displays the following message: 



RBA- XXXXX SECTOR WRITTEN. DATA ERROR. 
AN INVERTED ECC HAS BEEN WRITTEN. 

4 






In response to this message, refresh the data using secondary option 2. 

Secondary Option 7 — Exit 

Use secondary option 7 to end 4967 initialization (primary option 4) and to return to the 
primary option menu of $dasdi. Primary option 9 ends the $dasdi utility. 



o 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 5 — DDSK Disic Initialization 

The $DASDi utility identifies and restores defective sectors on the 30-megabyte disk device 
(DDSK-30) and the 60-megabyte disk (DDSK-60). For these devices, the system identifies disk 
sector addresses by relative block address (rba) rather than by cylinder, track, and sector. 

With this option, you can: 

• Verify all data fields and associated ids on the entire disk or a selected cyUnder. 

• Identify any defective RBAs. 

• Refresh data associated with a specific RBA. 

• Assign an alternate sector for a specified RBA. 

• List the assigned alternate sectors. 

• Remove an alternate sector assignment. 



The initialization routines for the DDSK-30 and DDSK-60 disks appear as primary option 5 
under the $DASDI utility. When you load $DASDI, it displays the following menu: 



^*%, 



> $L $DASDI 
LOADING $DASD! 



7P, 00:3^:11, LP=9D00, PART=1 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 

2 = ^962 DISK INITIALIZATION 

3 =4963 DISK INITIALIZATION 
k = 4967 DISK INITIALIZATION 
5 = DDSK DISK INITIALIZATION 
9 = EXIT DISK INITIALIZATION 

ENTER DISK INITIALIZATION OPTION: 5 



The storage capacity and the number of alternate sectors for DDSK-30 and DDSK-60 disks 
follows: 



Model 



Storage 
capacity (in bytes) 



SOD 
60D 



30,821,888 
61,668,864 



Alternate 
sectors 



3,544 
7,088 
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$DASDI - Format Disk or Diskette (continued) 



Enter a 5 in response to the enter disk initialization option prompt. $dasdi then prompts 
you for the address of the disk. Once you have entered the disk address, $dasdi displays the 
secondary options available under option 5. 

DDSK DISK INITIALIZATION ;;■■ : 

" WARNING " 

" NO USER PROGRAM SHOULD BE RUNNING * 

2^^^WHILE^PERF0RMI[NG^DISK [N ITI[AL l_ZAT mN^ ^^^^ Jl 

ENTER DEVICE ADDRESS OF D I SK (HEX): ^^ 
DDSK UTILITY PROGRAM 

OPTION MENU 

VERIFY ENTIRE DISK 

1 VERIFY CYLINDER BY SELECTED RBA 

2 REFRESH DATA 

3 ASSIGN ALTERNATE SECTOR 
k UNASSIGN SECONDARY ALTERNATE SECTOR 

5 LIST ALL USER ASSIGNED ALTERNATE SECTORS 

6 EXIT 
SELECT ONE OPTION: 



V 



Select one of the six secondary options listed above. A description of each secondary option 
follows. 
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$DASDI - Format Disk or Diskette (continued) 



Secondary Option — Verify Entire Disk 

Use secondary option to identify any defective rbas on the entire DDSK-30 or DDSK-60 
disks. The system reads and verifies all data fields and associated sector ids on the disk. If 
$DASDI finds no errors, it issues the following message: 



SELECT ONE OPTION: 

ENTIRE DISK BEING VERIFIED, IDS AND DATA 
NO SECTOR OR DATA ERRORS 



When using secondary option 0, no errors are expected to occur. However, if the system detects 
errors, you should correct them. $DASDI displays the relative block address, the sector ID of the 
RBA, the head and cylinder, and a comment describing each error. Following the error 
description, $DASDI displays the recommended way to correct each error. 



ENTIRE DISK BEING VERIFIED, 
ERROR SECTORS 

RBA ID-FG/SEC 



DS AND DATA 



01222 

11111 
11111 
12346 
BEED8 



32kk 
32kk 
32iti» 
3645 
0000 



HD/CYL 

0011 
0101 
0101 
0D02 
023A 



NRF - ID NOT VALID 
NRF - ID NOT READABLE 
DATA ERROR 

SOFT ERR - ECC CORRECTED 
DATA ERR - ECC INVERTED 



RECOMMENDED WAY TO CORRECT LISTED ERRORS: 



NO RECORD FOUND - I D NOT READABLE - ASSIGN 



NO RECORD FOUND - ID NOT READABLE - ASSIGN 



NRF - ID NOT VALID: 
AN ALTERNATE. 
NRF - ID NOT READABLE: 
AN ALTERNATE. 

DATA ERROR: READ AND CORRECT RECORD. USE OPTION 2 TO REFRESH 
RECORD, IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 
DATA ERROR: CORRECTED ECC. USE OPTION 2 TO REFRESH RECORD. 
IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 

DATA ERROR: INVERTED ECC. USE OPTION 2 TO REFRESH RECORD. 
IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 



Note: Use of secondary option causes all system processing to stop until secondary option 
completes. This option takes approximately 6 minutes to complete since it is reading and writing 
every sector on the disk. 

If you suspect that there is a defective rba (as indicated by a disk error message), use secondary 
option 1 to verify that particular rba. 
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$DASDI - Format Disk or Diskette (continued) 

Secondary Option 1 — Verify a Cylinder by Selected RBA 

Use secondary option 1 to identify defective rbas on a particular cylinder. The system reads 
and verifies all data fields and associated IDs on the selected cylinder. If $DASDI finds no errors, 
it issues the following message: 



SELECT ONE OPTION: 1 

ENTER RELATIVE BLOCK ADDRESS (RBA) 5 HEX DIGITS (RRRRR): 12456 

SELECTED CYLINDER BEING VERIFIED, IDS AND DATA 
NO SECTOR OR DATA ERRORS 



$DASDI displays the relative block address, the sector id of the rba, the head and cylinder, and a 
comment describing any error it finds. Following the error description, $DASDI displays the 
recommended way to correct the error. 



ERROR SECTORS 




RBA ID-FG/SEC 


HD/CYL 


11111 3645 


0D02 



DATA ERR-ECC INVERTED 



RECOMMENDED WAY TO CORRECT LISTED ERRORS: 

DATA ERROR: INVERTED ECC 

USE OPTION 2 TO REFRESH RECORD. IF ERROR PERSISTS, ASSIGN AN ALTERNATE. 



Secondary Option 2 — Refresh Data 



Use secondary option 2 to refresh the data contained in the sector to ensure it is valid or correct. 
You are able to patch data in the suspected rba and write the new data back out to the rba. If 
the error disappears, the rba can be used as is. If the error remains, then you must assign an 
alternate sector (secondary option 3). 

Notes: 

1. For inverted ECC errors, if you write the rba back without correcting the error, the inverted 
ECC error disappears. However, the data could still be bad. Be sure to verify the data. 

2. For ECC corrected errors, you don't need to verify the data before writing it back to disk. 
Example: 

SELECT ONE OPTION: 2 

ENTER RELATIVE BLOCK ADDRESS (RBA)-5 HEX DIGITS (RRRRR): 12346 
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$DASDI - Format Disk or Diskette (continued) 



At this point, $dasdi reads the selected rba and displays the 256 bytes (1 record), in 
eight-words-per-line format, contained in the rba. 






0000: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0010: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0020: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0030: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0040: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0050: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0060: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0070: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0080: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0090: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOAO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOBO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOCO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OODO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOEO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOFO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 



$DASDI then prompts you as follows: 
I PATCH THE RBA IN STORAGE? 

If you enter Y, $dasdi issues a prompt for the starting address and number of words (count) of 
the patch: 



L 



ENTER ADDRESS, COUNT: FO 1 



$DASDI then displays the address of the area you want to patch and the data currently appearing 
at that location. Enter the new data. 



V 



OOFO: 0000 
DATA: 5 
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$DASDI - Format Disk or Diskette (continued) 



$DASDI displays the selected rba showing the selected address and changed data. 



0000: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0010: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0020: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0030: 


0000 


0000 
0000 


0000 
0000 


0000 
0000 


0000 
0000 


0000 
0000 


0000 


0000 




0000 




OO^tO: 


0000 


0000 


0050: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0060: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0070: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0080: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0090: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOAO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOBO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOCO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OODO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOEO: 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


OOFO: 


0005 


0000 


0000 


0000 


0000 


0000 


0000 


0000 



$DASDI then prompts if you wish to patch another area. 



I 



ANOTHER PATCH? 



If you respond Y, $dasdi issues the enter address,count prompt. If you respond N, $dasdi 
asks if you wish to write the patched rba to disk. 



I 






WRITE THE RBA TO DISK? 



If you respond Y, $dasdi writes the changed rba back to the disk and prompts if you want to 
read another rba. 



WRITE THE RBA TO DISK? Y 
WRITE DATA RECORD COMPLETED 
READ ANOTHER RBA? 



If you respond N, $DASDI asks if you wish to read another rba. If you respond Y, $dasdi again 
prompts for the selected rba and displays the 256 bytes contained in that RBA in 
eight-word-per-line format. If you respond N, $dasdi returns to the DDSK Disk Initialization 
menu. 



^fcJ^ 
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$DASDI - Format Disk or Diskette (continued) 

Secondary Option 3 — Assign Alternate Sector 

Use secondary option 3 to assign alternate sectors for a selected rba. When assigning alternate 
sectors, you should be familiar with the layout of the disk. Each track contains 68 sectors 
(rbas) for your use plus up to two sectors for use as alternates. The alternate sectors on the 
same track are called primary alternate 1 and primary alternate 2. 

When an rba requires an alternate assignment, $dasdi attempts to assign primary alternate 1. If 
primary alternate 1 has already been assigned by the same rba or another rba, $dasdi attempts 
to assign primary alternate 2. If primary alternate 2 is also unavailable, $dasdi assigns a 
secondary alternate sector. The secondary alternate sector is always located on a track different 
than the track where primary alternates 1 and 2 are located. 

If a secondary alternate goes bad, you can assign another secondary alternate. However, using 
secondary option 4, you can unassign only the last secondary alternate that you assigned. 

Example: 

ENTER OPTION: 3 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123^*5 

ALTERNATE ASSIGNMENT COMPLETED 

Secondary Option 4 — Unassign Secondary Alternate Sector 

Use secondary option 4 to unassign the last secondary alternate sector that you assigned with 
secondary option 3. You can only unassign a secondary alternate. 

Example: 

ENTER OPTION: h 

ENTER RELATIVE BLOCK ADDRESS (RBA)-(HEX) 5 DIGITS (RRRRR): 123't5 

ALTERNATE UNASSIGNMENT COMPLETED 

If the RBA you specified is not a secondary alternate sector, $DASDI issues the following prompt: 

NO USER SECONDARY ALTERNATE FOUND 
ALTERNATE UNASSIGNMENT NOT COMPLETED 
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$DASDI - Format Disk or Diskette (continued) 



Secondary Option 5 — List All User-Assigned Alternate Sectors 

Use secondary option 5 to display a list of alternate sectors you assigned. $dasdi issues a listing 
of all the primary and secondary alternates assigned. 

Example: 

r 



SELECT ONE OPTION: 5 



USER ASSIGNED ALTERNATE SECTORS 



RBA 


ID-FG/SEC 


HD/CYL 


01222 


llkk 


0011 


01222 


3245 


0011 


11111 


3244 


0101 


11111 


3245 


0101 


11111 


3645 


0D02 


12346 


3244 


0112 


12346 


3245 


0112 



PRIMARY ALTERNATE 1 

PRIMARY ALTERNATE 2 

PRIMARY ALTERNATE 1 

PRIMARY ALTERNATE 2 
SECONDARY ALTERNATE 

PRIMARY ALTERNATE 1 

PRIMARY ALTERNATE 2 



The ID-FG/SEC column contains two bytes. The first byte in this column is a flag byte which 
indicates the condition of the sector's surface. The second byte is a sector byte which is the 
hexadecimal representation of the alternate sector assigned. For a description of the flag and 

sector bytes, refer to one of the following hardware description manuals: 

/ 

• IBM Series/ 1 4952 Processor Model SOD Processor Features Description, GA34-0251 

• IBM Series/ 1 4954 Processor Model SOD and Model 60D and Processor Features Description, 
GA34-0252 






• IBM Series/ 1 4956 Processor Model SOD and Model 60D and Processor Features Description, 
GA34-0253 

• IBM Series/ 1 4965 Storage and I/O Expansion Unit Description, GA34-0254 

Secondary Option 6 — Exit 

Use secondary option 6 to end DDSK initialization (primary option 5) and return to the primary 
option menu of $DASDI. Primary option 9 ends the $DASDI utility. 



\^ 
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$DASDI - Format Disk or Diskette (continued) 

Primary Option 9 — Exit Initialization 

Use primary option 9 to end the $dasdi utility. 



> $L $DASDI 
LOADING $DASDI 



7P, 00:3^:11, LP=9D00, PART=1 



DIRECT ACCESS DEVICE INITIALIZATION 
DISK INITIALIZATION OPTIONS: 

= CREATE STAND-ALONE DUMP/$TRAP DISKETTE 

1 = DISKETTE INITIALIZATION 
^962 DISK INITIALIZATION 
i*963 DISK INITIALIZATION 
^967 DISK INITIALIZATION 
DDSK DISK INITIALIZATION 
EXIT DISK INITIALIZATION 



2 = 

3 = 
k = 
5 = 
9 = 

ENTER 



DISK INITIALIZATION OPTION; 9 



$DASDI ENDED AT 01:12:29 



^llti^uMl'^ 
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o 



Use $DEBUG to locate errors in programs. All of your interactions are through terminals; none 
require the use of the optional programmer console. By operating a program under control of 
$DEBUG, you can: 

• Stop the program each time execution reaches an instruction address (breakpoint), that you 
have specified. 

• Trace the flow of execution of instructions within the program by specifying one or more 
ranges of instruction addresses known as trace ranges. Each time the program executes an 
instruction within any of the specified trace ranges, the terminal displays a message 
identifying the task name and the instruction address just executed. You may stop program 
execution after the system executes each instruction within a trace range. You may restart 
program execution at other than the next instruction. 

• List additional registers and storage location contents while the program is stopped at a 
breakpoint or at an instruction within a trace range. 

• Patch the contents of storage locations and registers. 

• Restart program execution at the breakpoint or trace range address where it is currently 
stopped. 

You can determine the results of computations performed by the program and the sequence of 

instruction execution within the program. You can also modify data or instructions of the 

program during execution. /*" \^ 

\> 
Major Features of $DEBUG 

A summary of the major features of the $DEBUG program follows: 

You can establish multiple breakpoints and trace ranges. 

You can debug overlay segments. 

Up to five users can employ separate copies of $debug concurrently if the system has 
sufficient storage available. 

You can set breakpoints and trace ranges in the Series/ 1 assembler language as well as in 
Event Driven Language instructions. 

The system automatically obtains the task names from the program you are testing. 

You can display and modify task registers #1 and #2. 

You can display and modify hardware registers RO through R7 and the lAR. 

You can display and modify the task return code words. 
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$DEBUG 

$DEBUG - Debugging Tool (continued) 

• The list and patch functions accept five different data formats. 

• You can run the program you are debugging in a partition other than the one where $DEBUG 
is loaded. 

• You can make all address specifications as shown in the program assembly listing without 
concern for the actual storage addresses where the system loads the program into storage 
for testing. 

• The task where you set the trace ranges is the only place that incurs processing overhead. 
Even then, the system enables the hardware trace feature only for specific tasks. 

• You can activate the debug facility for a program that is experiencing problems even if you 
previously loaded that program without the debug facility. 

• You can debug a program by loading $DEBUG from a terminal other than the one from which 
you loaded the program you are testing. 

• You can debug a program that uses a 4978, 4979, 4980, or 3101 terminal in STATIC or ROLL 
screen mode. 

• You can list breakpoints or trace ranges specified during a debug session. 

• $DEBUG can control the execution of programs containing up to 20 tasks. 

Necessary Data for Debugging 

To use $DEBUG, you must include $DBUGNUC at system generation. You must have a printed 
hsting of the program you are debugging that shows the storage addresses of each instruction 
and data area of interest. To obtain such a listing using $S1ASM, specify PRINT GEN in the source 
program, after the program statement, at assembly time. Precede the PROGRAM statement 
with PRINT NOGEN to prevent the system from printing many system EQU statements, among 
others. For $edxasm, you can get a satisfactory listing if you specify LIST. 

To debug segment overlays, you need a link map to find the overlay segment numbers. 

For an example of debugging an application program, see the Event Driven Executive Language 
Programming Guide. 



Chapter 4. Utilities UT- 1 27 



$DEBUG 

$DEBUG - Debugging Tool (continued) 



Invoking $DEBUG 



Invoke $debug with the $L operator command. The session manager does not support this 
utihty. 

> $L $DEBUG 

LOADING $DEBUG 31P ,09:37 : 17 , LP=C200, PART=1 

$DEBUG then prompts for the name of the program you wish to debug as follows: 

I PROGRAM (NAME, VOLUME): DBUGDEM0,EDX002 I 

The program that you are debugging does not have to run in the same partition where the 
system loaded $debug. After you enter the program name, the system prompts you for a 
partition number. The system prompts you for a terminal name only if $DEBUG is loading your 
program. (You may enter the partition number and terminal name on the same line as the 
program name if you prefer.) 

PARTITION (DEFAULT IS CURRENT PARTITION): 3 
TERMINAL NAME (DEFAULT IS CURRENT TERMINAL): SSYSLOG 

The system will inform you if there is not enough room for your program in the partition you f^ A 

specified or if you specified an invalid partition number. You may specify as a partition ^^V 

number to tell $debug to load your program in the first available partition. $debug will not 
look to see if your program is already in storage. 

Note: Do not enter the name of a printer when prompted for the name of the terminal on which 
$DEBUG is to load your application program. 

After you enter the partition number and the terminal name, if applicable, $debug displays the 
load point of the program as follows: 

I LOADING DBUGDEMO 4P, 09: 10:28, LP= 2000,PART= 3 I 

If you have loaded the program you are debugging into storage multiple times, the system lists 
the load points of all currently active copies as follows: 

I ALREADY ACTIVE AT 5200 5600 5A00 J 
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$DEBUG - Debugging Tool (continued) 



You have the option of requesting a fresh copy of the program or specifying which copy of the 
program you wish to debug. 



I: 



DO YOU WANT A NEW COPY TO BE LOADED? 



J 



If you respond "Y," $DEBUG loads a new copy of the program. 

I LOADING DBUGDEMO k? , 09:38:02, LP= 5E00 



If you respond "N," $DEBUG prompts you for the load point of the copy you wish to debug. 



J 



PROGRAM LOAD POINT: 5600 

LOADING DBUGDEMO k? , 09:38:02, LP= 5600 



$DEBUG Commands 






To display the $DEBUG commands at your terminal, press the attention key and enter the HELP 
command as follows: 

> 

> HELP 



HELP - LIST DEBUG COMMANDS 

WHERE - DISPLAY TASK STATUS 

LIST - DISPLAY STORAGE OR REGISTERS 

PATCH - MODIFY STORAGE OR REGISTERS 

QUALIFY - MODIFY BASE ADDR 

AT - ESTABLISH BREAKPOINTS 

OFF - REMOVE BREAKPOINTS 

GO - START TASK PROCESSING 

POST - POST EVENT OR PROCESS INTERRUPT 

PRINT - DIRECT LISTING TO PRINTER 

BP - LIST BREAK POINTS 

GOTO - CHANGE EXECUTION SEQUENCE 

CLOSE - CLOSE SPOOL JOB CREATED BY $DEBU6 

END - TERMINATE DEBUG FACILITY 



You specify each command by pressing the attention key on your terminal and entering the 
command name or the command name plus the required parameters for the command. 
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$DEBUG - Debugging Tool (continued) 



Syntax Summary 



The following examples show the various formats of the at command. Example 1 shows 
interactive mode and example 2 shows single-line entry. Syntax examples for each command 
capitaUze the $DEBUG command keyword parameters and show the variable parameters in 
lowercase. A slash (/) separates the keyword options that you can specify. 

Example 7: 



> AT 

OPTION{*/ADDR/TASK/ALL): TASK 

TASK NAME: TIMET 

LOW ADDRESS: 

HIGH ADDRESS: 3000 

LI ST/NOLI ST: LIST 

OPTION(*/ADDR/RO. . .R7/#l/i!'2/ I AR/TCODE/UNMAP) 

TASK NAME: L00P2 

LENGTH: 2 

MODE(X/F/D/A/C/E/L): F 

STOP/NOSTOP: NOSTOP 

1 BREAKPOINT(S) SET 



Example 2: You can obtain identical results by entering the single response. However, when 
using single-hne entry, be sure that you enter the parameters in the order $DEBUG expects them. 



V 



AT T TIMET 3000 L 
1 BREAKPOINT(S) SET 



#1 LO0P2 2 F N 






Each command with its syntax description follows in alphabetical order. 
AT — Set Breakpoints and Trace Ranges 

AT sets breakpoints and trace ranges. The system executes the list and stop options 
established for a breakpoint or trace range prior to executing the instruction that satisfied the 
breakpoint or trace range specification. When the system satisfies the specification for a 
breakpoint or trace range, it reroutes the currently active task. Then $debug performs the 
following actions for the subject task: 

• Prints its status and the current value of the task code word 

• Prints the list specification 

• Optionally puts the task into a wait state. 

If you requested the nostop option, $debug prints task status as "taskname checked at 
xxxx." The STOP option generates a "taskname stopped at xxxx" message. 



o 
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$DEBUG - Debugging Tool (continued) 



You can modify the list and stop options for all currently defined breakpoints and trace ranges 
by entering AT ALL. Similarly, you can alter the specifications for the most recently entered AT 
command with the at * option. 

If you specify LIST UNMAP after issuing the at command, the unmapped storage area to be listed 
must already be initialized at the time you set the breakpoint. 

Notes: 

1 . You cannot set breakpoints in ATTNLIST routines. 

2. If a trace range is set around a getvalue coded with PROMPT=COND and a message 
data set prompt, the instruction will not wait for input. The input data area will be 
unchanged. 

Syntax: 



AT ADDR address overlay# NOLIST/LIST NOSTOP/STOP 

AT TASK taskname start-add end-add NOLIST/LIST NOSTOP/STOP 

AT ALL NOLIST/LIST NOSTOP/STOP 

AT * NOLIST/LIST NOSTOP/STOP 



Operands Description 

ADDR Keyword indicating this is an instruction program breakpoint specification. 

address Instruction address where you want to insert a breakpoint. 

Note: Be sure that this is the address of the first word of an executable 
instruction, since $DEBUG will modify this word. $DEBUG can give unpredictable 
results if you specify the address of data or the address of other than the first 
word generated by an instruction. 

overlay* Overlay segment number where the system sets the breakpoint when the address 

you specified is within the overlay area. You can find the overlay segment 
number in the link map of the program you are debugging. 

NOLIST You need no special print request at this breakpoint or trace range. 

LIST Complete specification for a storage or register display; see the list command 

for a description of all list options and parameters. 

NOSTOP Processing continues after the breakpoint notification occurs. 

STOP The task stops whenever the system satisfies this breakpoint or trace range 

specification. 
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TASK Trace range specification. 

taskname Name of task you want to trace (if the program contains only one task, bnlit this 

parameter). 

start-add Trace range starting address (since your program is hot actually modified by a 

trace specification, you don't have to use special care when you enter trace 
addresses). 

end-add Trace range ending address. 

ALL The system redefines all currently defined breakpoints; and trace ranges with new 

list and stop options. 

* The system redefines the most recently defined breakpoint or trace range 

specification. The system determines this specification by the last usage of an 
AT, GO, or OFF commands. 



BP — List Breakpoints and Trace Ranges 



BP displays all breakpoints and trace ranges that you specified for the current debug session. 
For each breakpoint, bp displays the task address, the instruction type^ the associated list 
options, and the overlay segment number, and it indicates Whether you specified a stop. 

Syntax: 




if ^\ 






Operands Description 
None 



CLOSE — Close Spool Job Created by $DEBUG 

CLOSE closes the spool job created by the last print command you issued to a spoolable device. 

Example: CLOSE command. 



> CLOSE 
SPOOL JOB CLOSED 
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$DEBUG - Debugging Tool (continued) 

A spool job is created when a list command is sent to a spooling device. Issueing a CLOSE 
command will close this spool job and make it ready for printing. Only the spool job associated 
with the most recent PRINT command is closed. IF $spool is active and there is no job to close 
(in other words, no list command has been issued between a print command and a CLOSE 
command,) a spool job will be created consisting of an ENQT and a DEQT. If $SPOOL is not 
active, such a command will be ignored. Delete such empty jobs to release space. 

If $SPOOL is not active, you will receive the following message: 

> CLOSE 

SPOOLING NOT ACTIVE 



Syntax: 



CLOSE 
Required: none 



Operands Description 



none 



END — End$DEBUG 



END removes all currently-active breakpoints and trace ranges, activates all currently-stopped 
tasks, and ends $debug. Do not use the $c operator command to cancel $debug. 

Note: If the program you are debugging continues to execute after you ended $debug, then you 
can cancel the program by pressing the attention key and entering the $C operator command and 
the program name. 

Syntax: 



END 
Required: none 



Operand Description 
None 
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GO — Activate a Stopped Task 



GO reactivates any task that $debug has stopped. If a task stops at a breakpoint, specify the 
exact breakpoint address. If a task stops as a result of a trace specification, supply the name of 
the task and an address range which brackets the addresses in the original trace request. If you 
are debugging only one task, you don't need to specify any operands. 

Syntax: 



GO ADDR address 

GO TASK taskname 

GO ALL 

GO* 

GO 



Operands Description 

ADDR Keyword indicating this is a breakpoint specification. 

address Instruction address where the task stops. 

TASK Keyword indicating this is a trace range specification. 

taskname Name of task you want activated. For programs containing only a single task, 

omit this parameter. 

ALL Activate all currently stopped tasks. 

* Use the most recently referenced breakpoint or trace range specification. The 

system determines this specification by the last usage of an at, go, or off 
command. 






v/ 
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$DEBUG - Debugging Tool (continued) 



GOTO — Change Execution Sequence 



GOTO reactivates, at a different instruction, any task that has stopped at an Event Driven 
Language or Series/ 1 assembler instruction. If you used a breakpoint or trace to stop the task, 
supply the current address and the address at which execution should be resumed. $debug will 
not change the breakpoint or trace specifications. 

Syntax: 



GOTO current-address new-address 






Operands Description 

current-address Address where the task stops. 

new-address Address where you want execution restarted. 

HELP — List $DEBUG Commands 

The HELP command produces a list of $debug commands and functions. 

Syntax: 



HELP 
Required: none 



Operands Description 
None 
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LIST — Display Storage or Registers 



LIST displays the contents of storage locations, task registers, hardware registers, or the iar 
(instruction address register). You can display the LSB (level status block) by listing the IAR 
with a length of 11 words. Any register data is guaranteed to be current only if $DEBUG stops 
the corresponding task by a breakpoint or trace range. Use LIST * to repeat the most recently 
specified LIST command or to verify (list) a patch you have just entered. 

The following example shows the list command prompts. You can list the unmapped as well as 
the mapped storage that your program acquired previously with the GETSTG command. 

Example: LIST command for unmapped storage. 



> LIST 

'OPTION(*/ADDR/RO. . .R7/#1/#2/ I AR/TCODE/UNMAP) : UNMAP 

STORBLK ADDRESS (0 TO CANCEL LIST): 3^ 

SWAP#: 1 

DISPLACEMENT: 12 

LENGTH: 50 

MODE(X/F/D/A/C): X 



Syntax: 



LIST* 

LIST ADDR address length mode 

LIST R0...R7 taskname length mode 

LIST #1 ...#2 taskname length mode 

LIST IAR taskname length mode 

LIST TCODE taskname length mode 

LIST UNMAP storblkaddress swap# displacement length mode 



\.J 



Operands 



Description 



* Use the most recently specified LIST or PATCH specification. The system 

determines this by the last usage of a list or patch command. 

ADDR Keyword indicating this is a display of a mapped storage location. 

R0...R7 One of the Series/ 1 hardware registers RO through R7 where you want $DEBUG 

to start the list. 



\J 
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$DEBUG - Debugging Tool (continued) 

taskname Name of task where you want $DEBUG to display register data. For programs 

containing only a single task, omit this parameter. 

#l/#2 Task register #1 or #2 specification. 

lAR Keyword indicating you want $debug to display the lAR (instruction address 

register). 

TCODE Keyword indicating you want $DEBUG to display the task return code words (first 

two words of the tcb). 

UNMAP Keyword indicating this is a display of an unmapped storage location. 

storblk address Address of the storage statement that defines the unmapped storage location you 
want $DEBUG to display. (The address can be found in the program listing as the 
address of the storblk statement.) 

swap# Number of the unmapped storage area instruction. If you specify 0, you can Ust 

mapped storage. 

displacement Number of bytes (in hex) where you want to start listing an unmapped storage 
area. For example, if you enter lA, $debug begins patching from byte 26 of the 
unmapped storage area indicated. The largest possible value for displacement is 
^ X'FFFF' since the maximum size of an unmapped storage area is 64K. 

length Length of display in words, doublewords, or characters depending on mode. 

mode Mode of data display: 

X - hexadecimal word 

F - decimal number(word) 

D - decimal number(doubleword) 

A - relocatable address 

C - EBCDIC character 
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OFF — Remove Breakpoints and Trace Ranges 



OFF removes a breakpoint or trace range established with the AT command. To remove a 
breakpoint, specify the exact breakpoint address. To remove a trace request, specify the name 
of the task and an address range which brackets the addresses in the original trace request. If a 
task currently is stopped at the requested breakpoint or trace range, the system automatically 
reactivates the task. 

Syntax: 



OFF ADDR address overlay# 

OFF TASK taskname start-add end-add 

OFF ALL 

OFF* 



Operands Description 

ADDR Keyword indicating this is the removal of the breakpoint specification. 

address Instruction address where the system previously established a breakpoint. 

overlay* Overlay segment number from where you want $DEBUG to remove the 

breakpoint when the address specified is within the overlay area. You can find 
the overlay segment number in the link map of the program you are debugging. 

TASK Keyword indicating you want $DEBUG to remove a trace range. 

taskname Name of task associated with a trace range; for programs containing only a single 

task, omit this parameter. 

start-add Trace range starting address. 

end-add Trace range ending address. 

ALL Remove all breakpoints and trace ranges. 

* Use the most recently referenced breakpoint or trace range specification. The 

system determines this by the last usage of an at, go, or off command. 
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$DEBUG - Debugging Tool (continued) 



PATCH — Modify Storage or Registers 






PATCH modifies the contents of storage locations, task registers, hardware registers, task code 
words, and the lAR (instruction address register). You can modify the entire lsb (level status 
block) by patching the iar with a length specification of 11 words. The patch to any register 
data is guaranteed only if a $debug breakpoint or trace range stops the corresponding task. To 
respecify the data for the most recent patch or to patch the data the most recent list command 
displays, enter patch *. 

The following example shows the patch command prompts. You can patch unmapped as well 
as mapped storage. Unmapped storage may be patched only after the getstg statement is 
issued. 

Example: PATCH command for unmapped storage. 

r 



PATCH 

OPTION(*/ADDR/RO...R7/#1/#2/IAR/TC0DE/UNMAP): UNMAP 
STORBLK ADDRESS (0 TO CANCEL PATCH): 3^ 
SWAP#; 1 
DISPLACEMENT: 12 
LENGTH: 1 
MODE(X/F/D/A/C): X 
NOW IS 

0012 X' 0000' 
DATA: FFFF 
NEW DATA 

0012 X' FFFF' 
YES/NO/CONTINUE: Y 



After you enter the patch command, the system displays the current storage or register content, 
and you are prompted for the patch data (a string of data entries that satisfies the length and 
mode specifications). Use spaces to separate the entries. After you enter the patch data, you 
can apply the patch by responding yes, cancel the patch by responding NO, or indicate 
additional patches by responding continue to the prompting message. If you respond 
CONTINUE, the system performs the patch and prompting continues for new length, mode, and 
data specifications to storage or register locations immediately behind your previous patch. 

If you enter less data than specified with the length operand, the effective patch is padded to the 
right with blanks for character data and zeros for all other data types. 
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Syntax: 



PATCH * 

PATCH ADDR address length mode 

PATCH R0...R7 taskname length mode 

PATCH #1 /#2 taskname length mode 

PATCH lAR taskname length mode 

PATCH TCODE taskname length mode 

PATCH UNMAP storblkaddress swap# displacement length mode 



Operands 



Description 



* Use the most recently referenced list or patch specification. This is determined 

by the last usage of a list or patch command. 

ADDR Keyword indicating this is a mapped storage patch. 

R0...R7 One of the Series/ 1 hardware registers RO through R7, where you want $debug 

to start the patch. 



taskname Name of task for which you want $debug to modify register data. For programs 

containing only a single task, omit this parameter. 

#l/#2 Task register #1 or #2 specification. 

lAR Keyword indicating you want the lAR (anstruction address register) to be 

modified. 






TCODE Keyword indicating which task return code word(s) (first two words of the TCB) 

you want modified. 



UNMAP 



Keyword indicating this is an unmapped storage patch. 



storblk address Address of the storage statement that defines the unmapped storage location you 
want $DEBUG to display. (You can obtain this address from the program 
header on a copy of your application program.) 

swap# Number of the unmapped storage area instruction. If you specify 0, you can list 

mapped storage. 



^iiiiJf^ 
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$DEBUG - Debugging Tool (continued) 

displacement Number of bytes (in hex) where you want to start Usting an unmapped storage 
area. For example, if you enter lA, $debug begins patching from byte 26 of the 
unmapped storage area indicated. The largest possible value for displacement is 
X'FFFF' since the maximum size of an unmapped storage area is 64K. 

length Length of patch in words, doublewords, or characters depending on mode. 

mode Mode of data entry: 

X - hexadecimal word 

F - decimal number(word) 

D - decimal number(doubleword) 

A - relocatable address 

C - EBCDIC character 

POST — Post an Event or Process Interrupt 

POST activates a task waiting for an event or a process interrupt. To duplicate a previous 
posting, enter POST *. The address of the ECB (event control block) that the system will post is 
contained in the second word of a wait instruction as shown on a program assembly listing. 
You can also post process interrupts by name using the PIxx option. 

Note: Be sure to enter a valid ECB address; an invalid address will result in unpredictable 
results. 

Syntax: 



POST ADDR address code 
POST PIxx code 
POST* 



Operands Description 

ADDR The address of an ECB (event control block). 

address ECB address you want posted. 

code Decimal code you want posted to the specified ECB. 

PIxx Name of process interrupt PIl to PI99. 

* Use the most recently referenced ecb address or PIxx name and code specification. 
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QUALIFY — Modify Base Address 

QUALIFY modifies the base address that $DEBUG uses to refer to physical storage locations. 

Syntax: 



QUALIFY base displ 
Q base displ 



Operand Description 

base New hexadecimal base address. 

displ Hexadecimal offset you want added to the base to form the new base address for 

all subsequent address references. Enter the origin of the program module as 
shown on the hnk editor Usting. 



PRINT — Direct Output to Another Terminal 



PRINT allows you to direct the output to a terminal other than the one you used to invoke 

$DEBUG. 

Syntax: 



.V 



PRINT terminal-name 

PRINT* 

PRINT 



Operands Description 

terminal-name The name of the terminal where you want the output directed. To direct the 
output back to the current terminal, enter a blank or * to indicate the 
terminal you used to invoke $debug. 



xJ 
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WHERE — Display Status of All Tasks 






WHERE displays the current status of each task. If a task is currently processing its breakpoint 
routine, the system marks it checked. If a breakpoint or trace request has stopped a task or if 
$DEBUG has not yet attached the main task, the system marks the task stopped. In all other 
cases, the system shows that each task is at the currently executing instruction, at the command 
it will start executing when dispatched by the task supervisor, or at the last command executed 
prior to entering a wait state. 

Note: $DEBUG can only locate tasks within a program if the task control blocks (tcbs) are 
chained together. This chaining takes place at program assembly time for all tasks that are part 
of the assembly containing the main program task. Tasks that are assembled separately and 
then Unked to the main task will not have their tcbs chained together until the system ATTACHs 
the task at program execution time. (See a description of the ATTACH instruction in the 
Language Reference.) For $DEBUG to control tasks that are Unked to the main task, you must 
load into storage the program you are debugging, and you must attach the desired tasks before 
you load $debug to control the further execution of the tasks. 

Syntax: 



WHERE 
WH 

Required: none 



Operands Description 
None 
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Use the $dicomp utility to add display profiles to the composer and to modify existing display 
profiles. Because this utility does not change the basic structure of the online data base, you can 
use it at the same time you are performing other functions. You can use $diintr to cause the 
system to generate a partial display. If you need corrections or additions, use $dicomp to alter 
the display profile. 






Invoking $DICOMP 

You invoke $DIC0MP with the $L operator command or option 5.2 of the session manager. 

To start execution of $dicomp: 

1. Load the program $dicomp specifying the appropriate data set name. You can use $difile, 
the onUne data set, or any other data set. However, you should make sure that another user 
or program is not changing or using the same data set. 



V. 



> $L $DICOMP 

DISPLIB (NAME, VOLUME): 

LOADING $DICOMP 4i»P ,00: 19: 3^, LP= 9200, PART==1 



2. The system responds with the program-loaded message followed by: 



$OICOMP - DISPLAY DATA BASE COMPOSER 
COMMAND (?): 



V-.-j^ 



$DICOMP Commands 



To display the $dicomp commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 

COMMAND (?): ? 

AD - ADD A NEW MEMBER 

AL - ALTER EXISTING MEMBER 

EN - EXIT PROGRAM 

IN - INSERT OR DELETE DISPLAY ELEMENTS 

PR - PRINT MEMBER FORMATTED 

TD - TEST DISPLAY 

COMMAND (?): 



After $DicOMP displays the commands, it prompts you again with COMMAND (?):. Then you can 
respond with the command of your choice (for example, ad). 



N A MEMBER 



\J 
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AD — Add a New Member to Data Base 



Use the ad command to generate a new display profile. The display can be either report or 
graphic form. You are prompted to enter a 1-8 character display profile name that the 
interpreter will then use to retrieve the display. The next prompt message asks if you want a 
display heading. If you respond yes, the system assumes you want a report display. If you 
respond no, the system assumes you want a graphic display and prompts you to proceed with 
generating the display. You can also select the device where you want the system to route the 
output from the interpreter. 

Report Display: If you respond N to the question 



I 






IS THIS A GRAPHIC DISPLAY? 



$DICOMP prompts you to enter the column headings you want. The system allows one line, up 
to 132 characters. Following your entry of the column headings, $DiCOMP prompts you to enter 
the name of the print report data member and then to enter the next command. 

Graphic Display: If you want a graphic display, you should respond Y to the question 
I IS THIS A GRAPHIC DISPLAY? 

The composer then asks if you want a 3-D object display. If you respond Y, then all following 
references to X and Y values will also include the z value. The composer asks you to enter the 
values X, y, and z. The system uses them to position the first character of the display heading. 
$DIC0MP then prompts you for a command, COMMAND (?):. You can use the "Composer 
Subcommands" on page UT-147 now to add, change, or insert elements in your display. 



AL — Alter an Existing Member 



Use the al command to display each element of a display profile and make changes, using 
subcommands, provided you do not change the size of the element and the sequence of 
commands. This command is of great value during the trial-and-error period when you are 
generating a new display. You can generate a display using the AD command and display the 
results using the interpreter. You are allowed to start alteration at the beginning of the member 
and display each element in turn or to skip to a specific element within the member. Use the PR 
command to display the elements and their sequence numbers. As the system displays each 
element, it questions you whether or not you want to alter this element. 



l 



ALTER ENTRY? 



If you choose to alter this element, $DicoMP prompts you to reenter the element as described 
previously in the ad command. When the system reaches the end of the display profile, the 
composer ends and you can redisplay the profile to see if you are satisfied with the corrections. 
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EN — Exit Program 

Use the en command to exit immediately from the composer. 
IN — Insert or Delete Elements in an Existing iVIember 

Use the in command to combine the facilities of the al and AD commands with the ability to 
delete individual display elements. Because the in command creates a new member in the data 
base, you can change the size and sequence of display elements. 

Note: We recommend using the $dicomp utility to verify that sufficient space remains in the 
data base. By using the $diutil utihty (la and ST commands), you can determine the size of the 
member you want to modify and the remaining space in the data base. As described in the al 
command, the composer displays each element in turn, asking the following questions: 

KEEP ENTRY? 
DELETE ENTRY? 
ALTER ENTRY? 



If you elect to keep the entry, the composer proceeds to the next element. If you respond N, the 
system displays the delete entry? question. If you respond N again, the system displays the 
ALTER ENTRY? question. If you respond Y to'this prompt, the composer proceeds with the 
alteration process as described in the AL command. 

Following the alteration of the display, the system returns control to the ID command and /f"^\\ 

repeats the process for the next element. If you did not alter the element, the system prompts \^-JF 

you to insert a new subcommand. At this point, all the functions of the AD command are 
available. You can add one display element, the system then returns control to the ID command 
and redisplays the previous element and repeats the sequence. 

Again, as in the alteration procedure, you must step through each element in the display profile 
before completion. When the system reaches the end of the display, it issues the following 
message: 



I 



END OF DATA - ISSUE SAVE OR ADD NEW COMMANDS 



The composer then returns to the ad command and you can enter additional commands. 

Note: You must issue an SA (save) subcommand to end insertion of data. When you issue the 
SA subcommand, the composer deletes the old member and renames the newly-built member 
with the old name. This procedure makes the modified version available to the interpreter. It is 
recommended that you use $compres to compress the data base following insert activity to 
prevent fragmentation of the data base and reclaim unused space. 



^kmiti^ 
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PR — Print Member Formatted 



Use the PR command to display, on the terminal or printer, the contents of a display profile 
member formatted the same way as the al and IN commands. This display is useful as an aid in 
maintaining display profiles. To obtain a high-speed hard copy, direct the listing to the 

$SYSPRTR. 



TD — Test Display as Currently Entered 



When you issue the td command, $dicomp prompts you for the name of a plot control member 
and then invokes $DIINTR to generate the specified display. The system returns control to you to 
make changes. 



Composer Subcommands 



.y 



When adding, altering, or inserting elements in a member, use subcommands. These are listed 
below and described on the following pages. When you enter a subcommand, the system places 
it in to modify the member. The interpreter can use the member later to generate the desired 
display. You can use the following subcommands: 

AD - ADVANCE X,Y 

Dl - DIRECT OUTPUT 

DR - DRAW A SYMBOL 

EN - EXIT PROGRAM 

EP - END DISPLAY 

HX - SEND DATA (HEX) 

IM - INSERT MEMBER 

JP - JUMP TO ADDRESS 

JR - JUMP REFERENCE 

LB - DISPLAY CHARACTERS 

L! - DRAW A LINE TO X,Y 

LR - DRAW LINE RELATIVE 

MP - MOVE BEAM TO X,Y 

PC - PLOT CURVE ONLY 

PL - PLOT DATA 

RT - ACTIVATE REALTIME DATA MEMBER 

SA - SAVE ACCUMULATED DATA 

TD - DISPLAY TIME AND DATE 

VA- DISPLAY VARIABLE 



^ 



Method for Producing a Graphic Display 



The suggested method to produce a graphic display is to draw the display on graph paper first 
and assign x and Y coordinates to the key nodes in the display. Then use this drawing as a guide 
to the generation of the display, keeping in mind the screen limits of the terminal you will use. 
The view area of the graphic terminals supported is shown in Figure 11 on page UT-148. 
Figure 12 on page UT-148 shows the space supported in 3-D mode. 
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Figure 12. X,Y,Z coordinate grid and viewing area 
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$DICOMP- Display/Modify Profiles (continued) 



AD — Advance X,Y 



Use the ad subcommand to move the beam position by the value specified. This can be helpful 
in displaying data with even spacing on the screen. After issuing a DR subcommand using a 
symbol, AD advances the X,Y position to the next position without regard to the actual screen X,Y 
location. The limit for the specified X or Y value is plus or minus 512 units. If you are defining 
a 3-D object, then the system requests the z axis value as well. 



Dl — Direct Output 



Use the Dl subcommand to direct the resulting graphic output to a terminal other than the one 
you used to enter commands. The terminal name you enter is the label of the terminal 
statement used to describe the desired terminal. 



DR — Draw a Symbol 



Use the DR subcommand to draw a predefined symbol. Several commonly used symbols have 
been provided. In specifying a symbol, you are prompted to enter the symbol number and the 
symbol modifier. These values are used by the interpreter to generate the requested symbol. 
Some of the symbols require additional information. If so, the system prompts you for this 
additional information. Valid symbol numbers are 1 through 14. The following examples 
illustrate specifying symbols 1 through 14. 



Symbol # - 1 : Draw fan symbol left hand format. 



Modifier = Radius of fan body 

and opening on left side 

of fan. Must be a multiple of 4. 



= start and end X,Y current 
position. 




Symbol # - 2: Draw fan symbol right hand format. 



Modifier = Radius of fan body 

and opening on right side 

of fan. Must be a multiple of 4. 

= start and end X,Y current 
position. 






R 









Chapter 4. Utilities UT- 1 49 



$DICOMP 

$DICOMP - Display/Modify Profiles (continued) 



Symbol # - 3: Draw damper vertical. 






^ \ / 1 16 Units Y 

Modifier = Number of damper pairs 1 I 
to be generated in the down direction. 


40 Units X 
= start and end X,Y current position. 





Symbol # - 4: Draw damper horizontal. 



Modifier = Number of damper pairs 
to be generated to the right. 



= start and end X,Y current 
position. 



Symbol # - 5: Draw a hot coil. 



Modifier = Number of hot coil pairs 
to be generated in the down direction. 



= start and end X,Y current 
position. 



40 Units Y 



h — H 

16 Units X 



n 



n 



16 Units Y 



h — M 

12 Units X 



o 
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Symbol ff - 6: Draw a cold coil. 





• 


i , 








16 Units Y 


Modifier = Number of double pairs 
to be generated in the down direction. 




' ' 


= start and end X,Y current 
position. 


16 Units Y 





Symbol # - 7: Draw a filter element. 



% 





-^— 


i , 




\ 




16 Units Y 


Modifier = Number of elements 

to be generated in the down direction. 


l< » 


' ' 


= start and end X,Y current position. 


1* * 
8 Units X 





o 



Symbol # - 8: Draw a valve. 



For 2-way valve 
Modifier = 2 



For 3-way valve 
Modifier = 3 



= start and end X,Y current position. 




16 Units Y 



32 Units Y 
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Symbol # - 9: Draw an arrow. 








•c^d]^^ ' : 8 Units Y 
U ^1 


Modifier = 


' ^16 Units X' ' 




A " 


1 for left 


/\ 


16 Units Y 


2 for right 


/j •■ 


3 for up 

4 for down 


8 Units X KH 




\7'' 




\/ 


16 Units Y 


= start and end X,Y current position. 


V ' 


r 




* -j- 



o 



Symbol # - 10: Draw a logic block right. 



t 

Modifier = Radius of half circle. 2R 
Must be a nnultiple of 4. 

= start and end X,Y current position. 


r 


b 






Symbol # - 11 : Draw a logic block left. 



Modifier = Radius of half circle. „ ^ 
Must be a multiple of 4. V 

= start and end X,Y current position. 


i 
1 


2R 
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Symbol # - 12: Draw a circle. 



Modifier = Radius of Circle. 
Must be a multiple of 4. 



= start and end X,Y current position. 




Symbol # - 13: Draw an arc right. 






Modifier = Radius of circle. 
Must be a multiple of 4. 



= start and end X,Y current position. 

Note: 

This symbol requires additional values. 

1. Draw arc up or down. Enter zero for down or one for up. 

2. Number of Y units to draw arc. Must be a multiple of 4. 

Note: 

This symbol always starts at X=0 and proceeds until 
the Y units have been exhausted. 




Symbol # - 14: Draw an arc left. 



Modifier = Radius of circle. 
Must be a multiple of 4. 



= start and end. X,Y current 
position. 



Note: 



See note under symbol 13 for additional information. 
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EN — Exit Program 



Use the en subcommand to terminate without updating the display profile data base directory. 
All data collected up to this point for this member is lost. 



EP — End Display 



HX — Send Data 



Use the ep subcommand to specify that the end of this section of the display has been reached. 
Normally, you would follow this command with the SA subcommand. However, this command 
can be useful if a jump zero/not zero causes the interpreter to take alternate paths. Use the ep 
subcommand at the end of each of these paths instead of an unconditional jump to a common 
ending point. 



Use the HX subcommand to send up to 16 words of data without conversion to the terminal. All 
bit patterns are valid; therefore, you can send control or special data to the terminal. 



IM — Insert Member 



Use the IM subcommand to combine display profile members to form one display. IM allows you 
to conserve disk space, decrease time required to enter display profiles, and standardize display 
formats. For example, you can build a display profile member to represent a common 
background of a physical system or floor plan. Then, by defining another display profile 
member, you can superimpose on the background the variables that will make the display 
unique, the system permits only one level of nesting. That is, a member you insert using the IM 
subcommand cannot contain any IM subcommands. However, a primary member can include 
multiple IM subcommands. 






JP — Jump to Address 



Use the jp subcommand to change the sequence of execution of subcommands. There are three 
types of "jump to address" subcommands that you can use. They are: 

• Jump Unconditional 

• Jump if Zero 

• Jump if Not Zero 

As described in the display variable command, the conditional jump commands are dependent 
on the use of the realtime data member. If you select conditional jump, then the jump is based 
on the current condition (zero/not zero) of the specified word and record. Jump unconditional 
prompts you to enter a JR subcommand. This reference is two characters and is resolved when 
you define a JR subcommand (see the JR subcommand definition). If you select a conditional 
jump, the system issues prompt messages requesting word number and record number. 
Following the definition of these two codes, the system prompts you to enter the JR 
subcommand. The jump to reference for a conditional jump is the same as that of an 
unconditional jump. The following example shows the use of the JP subcommand. 
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Command sequence using jump: 



MP 


X=200, Y=200 




JP 


Zero, WORD#=0, 


REC0RD#=4, JR=AA 


DR 


SYM=1, M0D=40 




JP 


JR=BB 




JR 


AA 




DR 


SYM=2, M0D=40 




JR 


BB 




EP 






SA 







The preceding example draws a fan symbol at 200,200 either right or left depending on the 
zero/not zero condition of the realtime data member word 0, record 4. 

In the preceding sequence, the first JP causes a jump to JR AA if word of record 4 is zero. The 
second JP causes an unconditional jump to JR bb. 



JR — Jump Reference 






Use the JR subcommand to indicate to the composer that this location in the command sequence 
is referred to in a JP subcommand. The location is defined by 2 characters. If you have used 
these characters already, the system issues an error message. If you exceed the capacity of the 
JR table, the system issues an error message. The capacity of the jump reference table is 40 
unique jump reference points for each display. 



LB — Display Characters 



Use the LB subcommand to place a character string on the screen. You do not have to use an 
MP subcommand to position the beam because lb allows specification of the location of first 
character. If you are defining a 3-D object, then the system requests x, Y, and z values. The 
system can display up to 72 characters. The ending x,Y position is 1 character position beyond 
the last character in the string. 



LI — Draw a Line to X,Y 



Use the LI subcommand to draw a vector to the specified X and Y coordinates from wherever 
you left the beam with the previous command. 
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600- 
200- 


X 




1 1 
100 600 

Draw line to X=600 Y=600 Line shown on screen 
END X,Y Current position 





When generating a 3-D display, the system requires 3 values. These values are x, Y, and z. 









^^ 


^^ 








600 — 
— 


r 

1 








1 


/— 600 




1 

1 


/— 




1 1 

600 


Draw line to X=600 Y=600 Z=600 




END X,Y,Z 





LR — Draw Line Relative 



Use the lr subcommand to draw a line relative to the current position. For example, you can 
(through the use of the MP, jp, and JR subcommands) position the beam at various current 
positions based on Realtime Data Member conditions. Then you can draw a series of lines to 
form a symbol using the lr subcommand. This would have the effect of placing the symbol at 
various screen locations based on external conditions. The Umits allowed for the x,y values are 
plus or minus 512 units. If you are defining a 3-D object, then the system also requests z axis 
value. 



o 
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$DICOMP - Display/Modify Profiles (continued) 



MP — Move Beam to X,Y 



Use the MP subcommand to draw a dark vector to the specified X and Y coordinates. A dark 
vector is not visible and, therefore, results in moving the beam to the specified location. 









200- 


• 




1 
100 

Beam moved to X=100 Y=200 Nothing shown on screen 
END X,Y Current position 





When generating a 3-D display, the system requires 3 values. These values are x, Y, and z. 



100 _ 
— 



■r 




1 1 

100 



Beam moved to X= 100 Y=100 Z=100 
END X,Y,Z Current position 



PC — Plot Curve Only 



PL — Plot Data 



Use the PC subcommand to provide multiple curves on an existing background as defined by a 
preceding PL command. Refer to the following section (pl) for descriptions of entry procedure. 
Steps 9 and 10 in that section are the only required actions. You can include as many PC 
subcommands as you need to obtain the desired results 



Use the PL subcommand to format the viewing area into a basic plotter. The system provides 
options for x and Y labels as well as X and Y grids. The system prompts you to include the name 
of a plot curve data member. Refer to "$DIUTIL - Maintain Partitioned Data Base" on page 
UT-220 for information regarding the allocation and formatting of the plot curve data member. 
The following illustrates the information that PL requires to format the viewing area into a basic 
plotter. 1) Enter the number of the Y axis divisions 
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p.To present a readable display, it is suggested that you make this value under 20. However, if 
you bypass Y axis division values (Step 7), then you may use larger values, y axis divisions 
become unreadable when this value exceeds 125. 2) Enter the number of the x axis divisions 

To present a readable display, it is suggested that you make this value under 40. However, if 
you bypass x axis division values (Step 8), then you may use larger values. X axis divisions 
become unreadable when this value exceeds 200. 3) Vertical Grid? 

A Y answer causes the Composer to include commands to connect the X axis divisions (specified 
in 2 preceding) to the top of the viewing area. Specifying an N bypasses this feature. 4) 
Horizontal Grid? 

Specifying a Y causes the Composer to include commands to connect the Y axis divisions 
(specified in 1 preceding) to the right side of the viewing area. Specifying an N bypasses this 
feature. 5) Enter Y axis label - 24 characters 

You must enter the Y axis label. If you do not want an axis label, press the enter key. This label 
is general in nature and is placed at the left side of the viewing area. This label is vertical, that 
is, one character appears under the next. 6) Enter X axis label - 24 characters 

You must enter the X axis label. If you do not want an X axis label, press the enter key. This 
label is general in nature and is placed near the lower portion of the plot viewing area. 7) Y axis 
division values? 

If you want Y axis division values, respond with a Y. The composer asks for as many values as / m 

you have specified divisions plus 1 (see Step 1). You must enter 6 characters for each division. \..y 

The first value the system requests is the value for the Y base line and each succeeding value is 
for the next division in the plus Y direction. 8) x axis division values? 

If you want the X axis division values displayed, respond with a Y. The composer asks for as 
many values as you have specified divisions plus 1 (see Step 2). You must enter 6 characters for 
each division. The first value the system requests is the value for the X base line and each 
succeeding value is for the next division in the plus X direction. 9) Enter Name of Member for 
Plot Data 

Enter the name of a plot curve data member. You must must have allocated and initialized this 
member with the the utility program $DIUTIL. Refer to "$DIUTIL - Maintain Partitioned Data 
Base" on page UT-220 for procedures on allocating and initializing this member, lo) Is This 
Plot a Point Plot? 

The composer allows you to use of any valid printable character for the plot. If you specify Y, 
the system requests the plot character you want. If you specify N, then the system uses a normal 
Une for the curve 

The preceding steps generate the necessary commands to cause the system to display a basic 
plot background and superimpose one curve on that background. If you want additional curves, 
then you must issues PC subcommands next. 



o 
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RT — Activate New Realtime Data Member 



Use the rt subcommand to define multiple realtime data members. This subcommand allows 
you to switch from one member to another during the generation of a display. The default name 
for the realtime data member is realtime. 



SA — Save Accumulated Data 



Use the SA subcommand to specify that completion of a display profile has been reached. The 
composer enters the member name into the directory of the display profile data base and makes 
it available for the interpreter. 



TD — Display Time and Date 



Use the TD subcommand to display the current time of day and date from the realtime clocks 
used by the Event Driven Executive. You are reminded that prior to issuing a td subcommand, 
you may have to issue an MP subcommand to position the beam to the display location you want. 
The TD subcommand displays the time and date in the following format: 



L 



HH:MM:SS MM/DD/YY 






Where: HH is Hours 

MM is Minutes 
SS is Seconds 
MM is Month 
DD is Day 
YY is Year 



VA — Display Variable 



Use the VA subcommand to place a data variable from the Realtime Data Member on the 
screen. $DIC0MP issues a prompt message asking if you wish to locate the data at a location 
other than the current X,Y position. If you are defining a 3-D object, then the system requests X, 
Y, and z This subcommand requires that you allocate the realtime data member. The composer 
continues by asking you for the record number and word number. The record number is the 
record number within the realtime data member. The word number is the word number within 
the record specified. This value is in the range of 0—8. 

The system requests the function code next and indicates the type of variable to be displayed. 
Valid function codes are as follows: 

Single-precision integer 
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1 Double-precision integer 

2 Standard-precision floating point 

3 Extended-precision floating point 

15 Character data 

The system requests type code next. It is an indicator of the format of the value to be displayed. 
Valid type codes are: 






Integer 


1 


Floating-point F format 


2 


Floating-point E format 



The system requests field width and number of decimal places next. If the variable is an integer, 
the number of decimals should be zero. 
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$DIINTR - Graphics Interpreter Utility 

The $DIINTR interpreter utility searches the data base and generates the display you request. 
You can generate both graphic and report displays in this manner. Each display profile is made 
up of many display profile elements. Each element, when retrieved from the data base by the 
interpreter, is decoded and converted to the appropriate command to cause the system to 
perform the action you request. Each display profile element contains various parts, such as 
display code, x and Y coordinates, symbol ID, and symbol modifier. Realtime data member 
record number and additional member names are included in the display profile element. 

Invoking $DIINTR 

You invoke $diintr with the $L operator command or option 5.3 of the session manager. 

To begin operation of the interpreter, you must first load $DIINTR. The system directs output to 
the terminal that requests the display or as directed by the display profile. Use the following 
steps to initiate the processor monitor: l) Load $DIINTR. 

> $L $DI INTR 

DISPLIB (NAME, VOLUME): 

LOADING $DIINTR 38P ,00: 12: 58, LP= 9200, PART=1 

$D1INTR - DISPLAY DATA BASE UTILITY 



2) The system responds with the prompt message: 
y I ENTER DISPLAY ID--XXXXXXXX OR EXIT TO TERMINATE 



I: 



3) To terminate the interpreter, enter EXIT. To cause the interpreter to prepare the display, 
enter the display id. 



Using $DIINTR from an Application Program 



You can SDIINTR from an application program to allow displays without operator assistance. 
Following is an example of loading $diintr from an application program: 
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* Your 


progr 


am 




LOAD 


$DIINTR, MBRNME, DS=($DIFILE) , EVENT=#WAIT , C 




LOGMSG=NO 




WAIT 


#WAIT 




MBRNME 


DATA 


CL8' DISPLAY' 


SI 


DATA 


F'O' 


THESE 8 VALUES ARE FOR 3D OBJECTS 


S2 


DATA 


F'O' 


* 


S3 


DATA 


F'O' 


* 


D 


DATA 


F'O' 


* 


T 


DATA 


F'O' 


* 


R 


DATA 


F'O' 


* 


Dl 


DATA 


F'O' 


* 


T1 


DATA 


F'O' 


* 






You must supply eight values to describe the manner in which you want the system to display a 
three-dimensional (3-D) object. Coding of these values is shown in the above example starting 
with SI and continuing to Tl. The following describes the meaning of these values when you 
pass them to $diintr. 



SI 


Platform Location X= 


82 


Platform Location Y= 


S3 


Platform Location Z= 


D 


Platform Direction in Degrees 


T 


Platform Tilt in Degrees 


R 


Platform Rotate in Degrees 


Dl 


View Direction in Degrees 


Tl 


View Tilt in Degrees 



\.y 



These values are single-precision integers and may contain a numeric value from -32768 to 
+32767. 

You must have a 4955 processor with floating-point hardware installed to display 3-D images. 

Three-dimensional (3-D) Concepts as Used by $DIINTR 

Three-dimensional (3-D) objects can be defined by $dicomp and placed on disk or diskette in 
much the same way as with a two-dimensional (2-D) object. The only difference is that each 
point in space has three values associated with it instead of two. These three values represent 
the X, Y, and z coordinates of the point in space. The following illustration shows the limits of 
the defined area in space. The maximum limits of the defined areas in space are -32768 to 
+32767. You can define one or more objects within this cube. Once you define the object, you 
can view it from any location within the same space. To specify the location from where you 



^kii^Jr 
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$DIINTR - Graphics Interpreter Utility (continued) 



wish to view the object, either pass these eight values through the use of the parm= parameter 
in the LOAD instruction or, if you invoked it by the $L command, wait for $diintr to request this 
input. The concept used to compute the 2-D representation of a 3-D object is as follows. The 
system assumes the viewer is suspended on a platform at a specific location in space. The first 
three values are the x, Y, and z values that define the location in space of the viewing platform. 
The next five values represent the physical orientation of the platform and the viewer's 
orientation on that platform. 



Platform Direction in Degrees 



Assume the following unit vector: 




If this unit vector is rotated in the direction Y to X around the z axis, you can turn the view in 
any direction. A plus value causes the unit vector to rotate clockwise as viewed from the z axis 
to zero. 



Platform Tilt in Degrees 

Assume the following unit Vector: 




If this unit vector is rotated in the direction z to Y around the X axis, you can tilt the view to any 
angle. A plus value causes the unit vector to rotate clockwise as viewed from the X axis to zero. 
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Platform Rotate in Degrees 

Assume the following unit vectors: 







If this unit vector is rotated in the direction z to x around the Y axis, you can rotate the view to 
any angle. A plus value causes the unit vector to rotate clockwise as viewed from the -Y axis to 
zero. 



View Direction In Degrees 



The system uses this value in the same way it uses the Platform Direction, but it calculates the 
value after it computes the above three. This calculation rotates the unit vector in a y to x 
direction around the z axis with a plus value causing the unit vector to rotate clockwise as 
viewed from the z axis to zero. 



View Tilt In Degrees 



The system uses this value in the same way it uses the Platform Tilt, but it calculates the value 
after it computes the above four. This calculation rotates the unit vector in a z to x direction 
around the y axis with a plus value causing the unit to rotate clockwise as viewed from the -Y 
axis to zero. 

Once the eight values you provided are computed, the system converts the object in space to its 
2-D representation and sends it to the terminal. It is possible to view an object with all or a 
portion of it outside the viewing area. The system does not show points and lines that do not 
fall within the viewing area. Figure 13 on page UT-165 shows the viewing area. 
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$DIINTR - Graphics Interpreter Utility (continued) 



3D object in space 




Viewing screen 



Platform location 

Distance between platform location and viewing screen = 1 



Figure 13. Viewing Area in 3-D Mode 
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The following example defines a 3-D object in space: 



■ A Cube 








CMD 


X 


Y 


z 


MP 


-100 


-100 


-100 


LI 


+100 


-100 


-100 


LI 


+100 


-100 


+100 


LI 


-100 


-100 


+100 


LI 


-100 


-100 


-100 


LI 


-100 


+100 


-100 


LI 


+100 


+100 


-100 


LI 


+100 


+100 


+100 


LI 


-100 


+100 


+100 


LI 


-100 


+100 


-100 


MP 


+100 


-100 


-100 


LI 


+100 


+100 


-100 


MP 


+100 


-100 


+100 


LI 


+100 


+100 


+100 


MP 


-100 


-100 


+100 


LI 


-100 


+100 


+100 


EP 








SA 









Object as viewed from: 



400 



SI 





S2 


-I 


S3 





D 





T 





R 





D1 





T1 






o 



o 
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$DIINTR " Graphics Interpreter Utility (continued) 



Object as viewed from: 


-.:-::::-^ 


\ 




SI -150 










S2 -400 










S3 










D 




^____J 


-7 




T 


J^ 


/ 


R 


y^ ^ — 


/ 


D1 


^' '""''' 1 


T1 
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$DIRECT sorts a disk or diskette volume directory. $direct sorts alphabetically, by size, by 
location on disk, or in specific order. 

Notes: 

1 . Allocation or deletion of a data set alters the ordering of the data sets. 

2. It is neither possible nor necessary to use the $c command with $direct since the utility 
patches itself. 



Invoking $DIRECT 



You invoke $direct with the $L command. When you load it, $direct prompts you to set the 
terminal to roll screen mode. If you respond Y, it places the terminal in roll screen mode which 
means you do not need to press the enter key each time the screen fills up. Output "rolls" off 
the top of the screen as new terminal output appears at the bottom of the screen. If you respond 
N, you must press the enter key each time the screen fills up. 



> $L SDIRECT 
LOADING $DIRECT 



AOP, 00:23:30, LP= 9200, PART=1 



$DIRECT - DIRECTORY SORT 
WARNING: VOLUME DIRECTORY WILL 
BE ALTERED. SHOULD ONLY BE RUN 
WHEN NO OTHER PROGRAMS ARE ACTIVE! 

CONTINUE (Y/N)?Y 

SET TERMINAL IN ROLL MODE (Y/N)? 






SDIRECT then prompts you for the volume you want accessed for the directory sort. 



VOLUME LABEL: EDX003 
COMMAND {?): 



If you enter an incorrect or nonexistent volume name, $direct issues the following message: 



VOLUME NOT MOUNTED 
RETRY? 



V 



If you reply Y, $DIRECT prompts you for another volume name. If you respond N, $direct ends. 
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$DIRECT Commands 



To display the $DIRECT commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 

.^^ 

COMMAND (?): ? 



CV CHANGE VOLUME 

LA LIST ALL MEMBERS IN VOLUME 

UT SORT BY - USER INPUT FROM TERMINAL 

UD SORT BY - PREDEFINED DATA SET AS INPUT 

AO SORT BY - ALPHABETICAL ORDER 

DL SORT BY - LOCATION ON DISK(ETTE) 

SA SORT BY - SIZE ASCENDING 

SD SORT BY - SIZE DESCENDING 

EN END PROGRAM 

COMMAND (?): 



After $DIRECT displays the commands, it prompts you with COMMAND (?): again. Then you can 
respond with the command of your choice (for example, la). $direct prompts you for any 
parameters the requested function requires. 

Each command and its explanation is presented in alphabetical order on the following pages. 

AO — Alphabetical Order Sort 

Use the AO command to sort the directory in alphabetical order. This command makes it easier 
for you to find a data set in a directory list. 

Example: Sort alphabetically. 



COMMAND (?): AO 

ALPHABETICAL SORT USING VOLUME EDX002, CONTINUE (Y/N)? Y 

DIRECTORY SORTED 

COMMAND (?): 



o 



After executing the AO command, the directory looks as follows: 



NAME 


TYPE 


FIRST REC 


SIZE 


$EDXDEF 


DATA 


82 


kk 


DIRECT 


PGM 


iza't 


kk 


RUNCALC 


PGM 


77 


5 


SORTLIST 


DATA 


801 


.11 


TESTSORT 


DATA 


1177 


83 
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CV — Change Volume to be Accessed for Directory Sort 

Use the cv command to change the volume you want to access for your directory sort. This 
command displays the volume the system is using currently and prompts you for the name of the 
the volume you want to access, 

Example: Change volume. 



COMMAND (?): CV 
USING VOLUME EDX003 
NEW VOLUME LABEL =EDX002 
USING VOLUME EDX002 
COMMAND (?): 

DL — Sort By Location on Disk/Diskette 

Use the dl command to sort the directory by the data set location on disk/diskette. 
Example: Sort by location. 



COMMAND (?): ^L 

SORT BY LOCATION ON DISK(ETTE) USING VOLUME EDX002, CONTINUE (Y/N)?^ 

DIRECTORY SORTED 

COMMAND {?): 



\4 ^ 



After executing the dl command, the directory looks as follows: 



'v. 



NAME 


TYPE 


FIRST REC 


SIZE 


RUNCALC 


P&M 


77 


5 


SEDXDEF 


DATA 


82 


kk 


SORTLIST 


DATA 


801 


11 


TESTSORT 


DATA 


1177 


83 


DIRECT 


PGM 


1294 


kk 
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g^ $DIRECT - Directory Organization Sort (continued) 

EIM — End$DIRECT 

Use the EN command to end the $direct utUity. 

Example: End $direct. 

COMMAND {?): EN 

$DIRECT ENDED AT 08:36:02 



"X^ 
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$DIRECT - Directory Organization Sort (continued) 

LA — List All Data Sets in a Volume 

Use the la command to list all the data sets contained in a specified volume. Press the attention 
key and enter the CA command to cancel the list and return to the COMMAND (?): prompt. 

Example: List data sets on EDX002. 



COMMAND (?): LA 
USING VOLUME EDX002 



NAME 

TESTSORT 

RUNCALC 

DIRECT 

SORTLIST 

$EDXDEF 

COMMAND (?): 



TYPE 

DATA 

PGM 

PGM 

DATA 

DATA 



FIRST REC 

1177 

77 

801 

82 



SIZE 
83 
5 
kk 
n 
kk 



SA — Sort By Ascending Data Set Size 

Use the SA command to sort the directory by ascending (smallest-to-largest) data set size. 
Example: Sort directory in ascending order. 



COMMAND (?): SA 

SORT BY ASCENDING SIZE USING VOLUME EDX002, CONTINUE (Y/N)? ^ 

DIRECTORY SORTED 

COMMAND {?): 






•.^' 



After executing the SA command, the directory looks as follows: 



V 



NAME 


TYPE 


FIRST REC 


SIZE 


$EDXDEF 


DATA 


82 


^^ 


RUNCALC 


PGM 


77 


5 


SORTLIST 


DATA 


801 


11 


DIRECT 


PGM 


1294 


44 


TESTSORT 


DATA 


1177 


83 



J 
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SD — Sort By Descending Data Set Size 

Use the SA command to sort the directory by descending (largest-to-smallest) data set size. 
Example: Sort directory in descending order. 



COMMAND (?): SD 

SORT BY DESCENDING SIZE USING VOLUME EDX002, CONTINUE (Y/N)? Y 

DIRECTORY SORTED 

COMMAND (?): 



After executing the SD command, the directory looks as follows: 



NAME 


TYPE 


FIRST REC 


SIZE 


TESTSORT 


DATA 


1177 


83 


$EDXDEF 


DATA 


82 


kk 


DIRECT 


PGM 


1294 


kk 


SORTLIST 


DATA 


801 


11 


RUNCALC 


PGM 


77 


5 



Note: Sorting the directory in descending order can be beneficial if you want to copy 
the volume to another volume. By placing the largest members at the top of the 
directory, the system copies them first. This decreases fragmentation of disk space and 
gives you the best chance of doing the copy without having to compress the target 
volume. 



Chapter 4. Utilities UT- 173 



$DIRECT 

$DIRECT - Directory Organization Sort (continued) 



UD — Sort Directory in Predefined Order 



Use the ud command to place members in the order you feel is most desirable for retrieval. You 
can put the most frequently accessed data sets at the top of the directory to increase speed of 
retrieval. This command prompts you for a previously allocated data set containing the order, 
by data set name, in which you want the directory sorted. You create this data set using 
$FSEDIT. The system allows only one data set name for each 80-byte record and you must begin 
that name in column 1. The first record must be // and the last must be /*. The /* marks the 
logical end of data which may or may not be the physical end of data. 

Example: The following is an example of a data set named testsort on EDX002. 



EDIT — - TESTSORT, EDX002 

COMMAND INPUT ===> 

*"*"* '^*""" TOP OF DATA "' 

00010 // 

00020 DIRECT 

00030 WRONG 

OOO^tl SORTLIST 

00050 RUNCALC 

00070 $EDXDEF 

00090 TESTSORT 

00110 /" 

"*""" "*""" BOTTOM OF DATA 



8( 1362)- 



- COLUMNS 001 072 
SCROLL ===> HALF 



U A)/ 
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$DIRECT - Directory Organization Sort (continued) 



•'•'iifc. 



The utility reorders the directory as specified by the input data set. 

COMMAND (?): UD 
USING VOLUME EDX002 

A PREVIOUSLY ALLOCATED DATA SET IS REQUIRED, CONTINUE? Y 
ENTER (NAME, VOLUME): TESTS0RT,EDX002 

DIRECT HAS BEEN POSITIONED 

WRONG NOT FOUND 

SORTLIST HAS BEEN POSITIONED 

RUNCALC HAS BEEN POSITIONED 

$EDXDEF HAS BEEN POSITIONED 

TESTSORT HAS BEEN POSITIONED 

DIRECTORY SORTED 

COMMAND (?): 



>i 



The utility reorders the directory as follows: 



NAME 


TYPE 


FIRST REC 


SIZE 


DIRECT 


PGM 


1294 


kk 


SORTLIST 


DATA 


801 


11 


RUNCALC 


PGM 


77 


5 


$EDXDEF 


DATA 


82 


kh 


TESTSORT 


DATA 


1177 


83 



J 
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$DIRECT - Directory Organization Sort (continued) 

UT — Sort Directory in Desired Order Interactively 

Use the UT command to place members in the order you feel is most desirable for retrieval. You 
can put the data sets you access most frequently at the top of the directory to increase speed of 
retrieval. This command prompts you for member names you want to place at the top of the 
directory. A blank ends the command. 

Example: 



COMMAND (?): UT 
USING VOLUME EDX002 

INTERACTIVE MODE REQUIRES USER INPUT, CONTINUE (Y/N)? Y 

ENTER BLANK TO TERMINATE 

DATASET #1: SORTL I ST 

SORTLIST HAS BEEN POSITIONED 

DATASET #2: DIRECT 
DIRECT HAS BEEN POSITIONED 

DIRECTORY REORDERED 
COMMAND (?): 

The utility reorders the directory to look as follows: 



\J 



NAME 


TYPE 


FIRST 


REC 


SIZE 


SORTL 1 ST 


DATA 




801 


11 


DIRECT 


PGM 




1294 


kk 


TESTSORT 


DATA 




1177 


83 


RUNCALC 


PGM 




77 


5 


$EDXDEF 


DATA 




82 


kk 



m. J 
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$DISKUT1 

$DISKUT1 -Allocate/Delete/List Directory Data 

$DISKUT1 performs several commonly-used disk or diskette storage management functions. With 
this utility, you can: 

• Rename a data set. 

• List data sets. 

• Direct listings to $SYSPRTR or terminal. 

Note: For tape management functions, see "$TAPEUT1 - Tape Management" on page 
UT-522. 

Loading $DISKUT1 

You load $DISKUT1 with the $L command or option 3.1 of the session manager. 

> $L $DISKUT1 

LOADING $DISKUT1 52P ,00:28:08, LP= 9200, PART=1 

$DISKUT1 - DATA SET MANAGEMENT, UTILITY I 
USING VOLUME EDX002 

COMMAND (?): 
When you load $diskuti, it issues the following message: 



I 



USING VOLUME XXXXXX 



where xxxxxx equals the ipl volume. The $diskuti commands, with the exception of cv and 
EN, act upon the ipl volume. 

To point to another volume, enter the CV command and the name of the volume. All commands 
act upon the specified volume until you change them by another cv command or until you end 
and reload $diskuti. If you specify an invalid volume on a CV command, $DISKUT1 uses the ipl 
volume if it is available. If the ipl volume is not available, the system issues the message no 
VOLUME AVAILABLE. You can either end $diskuti or do a cv command with a vaUd volume. 



Chapter 4. Utilities UT- 177 



$DISKUT1 

$DISKUT1 - Allocate/Delete/List Directory Data (continued) 

$DISKUT1 Commands 

To display the $DISKUT1 commands at your terminal, enter a question mark in response to the 
prompting message command (?) : . 



/ 



r 



(?) 



COMMAND 

AL -- ALLOCATE A DATA SET 

CV -- CHANGE VOLUME 

DE -- DELETE A DATA SET 

DG " -- DELETE ALL MEMBERS STARTING WITH TEXT 

DGP " -- DELETE ALL PROGRAMS STARTING WITH TEXT 

DGD "" -- DELETE ALL DATA SETS STARTING WITH TEXT 

DNG " -- DELETE ALL MEMBERS NOT STARTING WITH TEXT 

DNGP " -- DELETE ALL PROGRAMS NOT STARTING WITH TEXT 

DNGD " -- DELETE ALL DATA SETS NOT STARTING WITH TEXT 

SQ -- SET PROMPT MODES 

SNQ -- RESET PROMPT MODES 

EN -- END THE PROGRAM 

LA " -- LIST ALL DATA SETS 

LACTS " -- LIKE LA BUT IN CTS/RBA MODE 

LD " -- LIST DATA TYPE DATA SETS 

LDCTS " -- LIKE LD BUT LIST IN CTS/RBA MODE 

LM -- LIST A SPECIFIC DATA SET 

LP " -- LIST PROGRAMS 

LPCTS " -- LIKE LP BUT IN CTS/RBA MODE 

LS -- LIST FREE SPACE 

LAV " -- LIST ALL VOLUMES 
LAD " --LIST DATA SETS ON ALL VOLUMES 

LISTP -- DIRECT LISTING TO $SYSPTR 

LISTT -- DIRECT LISTING TO TERMINAL 

RE -- RENAME A DATA SET 

SE -- SET END OF DATA POINTER/FLAG 

"- PREFIX (OPTIONAL) 

COMMAND (?): 



w 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 

After $DISKUT1 displays the commands, it prompts you once again with the prompt, command 
(?):. Then you can respond with the command of your choice (for example, al). Each 
command and its explanation is presented in alphabetical order on the following pages. 

Notes: 

1. You can enter a prefix on the commands that have an asterisk. The prefix can be up to eight 
(8) characters. If you do specify a prefix, the system Usts only those data sets beginning 
with the prefix. 

2. To cancel a long list, press the attention key, press the enter key, then enter CA. 
Note: For a 3101 display terminal, press the attention key and enter CA. 

3. If your system includes timer support and you direct output to the $sysprtr, the system 
includes the time and date in the listing. 

4. For the 4962 disk and the 4963 disk subsystem, the system shows disk locations in cylinder, 
track, and sector (CTS) format instead of by record number. 

5. For the 4967 disk subsystem, as well as DDSK-30 and DDSK-60 disks, the system shows 
disk locations in relative block address (rba) format instead of by record number. 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



AL — Allocate a Data Set 






Use the al command to allocate a data set. $diskuti prompts you for the following 
information: 

• The name of the data set 

• The size of the data set in records 

• The organization type. 

The Event Driven Executive recognizes two types of data sets: data- type and program-type. A 
data-type data set contains work files, user source modules, and application data sets. A 
program-type data set contains executable (loadable) edl programs. 

Select one of the following organization types: 

D Data organization for data sets used as work files, user source modules, and application 
data sets. 

P Program organization for data sets that will contain executable (loadable) Event Driven 
Executive Language programs. Use this for executable object programs (the output of 

$UPD ATE/ $UPD ATEH) . 

Example: Allocate a 100-record data-type data set named datafile. / \, 

COMMAND (?): AL 
MEMBER NAME: DATAFILE 
HOW MANY RECORDS? 100 
DEFAULT TYPE = DATA - OK? Y 
DATAFILE CREATED 

COMMAND (?): 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



CV — Change Volume 



Use the cv command to change the volume you want to access with other commands. $diskuti 
prompts you for the new volume label after you enter the cv command. 

Example: Change volume. 



COMMAND (?): CV 

NEW VOLUME LABEL = EDX002 



USING VOLUME EDX002 
COMMAND (?): 



DE — Delete a Data Set 



Use the DE command to delete a data set. $DISKUT1 prompts you for the name of the data set 
(member) you want to delete. 

Example: Delete a data set named datafile 



COMMAND {?): DE 
MEMBER NAME: DATAFILE 
DATAFtLE DELETE? Y 
DATAFILE DELETED 



COMMAND (?): 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 

DG — Delete All Members Starting with Text 

Use DG to delete data sets that start with a specific prefix. The system displays each data set 
starting with the specified prefix and $diskuti prompts you as shown in the example. If you do 
not want to display each data set, use the SNQ command to turn off the prompt mode. $diskuti 
then deletes the appropriate data sets without verification. 

Example: Delete all data sets starting with the prefix $z. 



COMMAND (?): DG 

ENTER GENERIC TEXT: $Z 

DELETE ALL MEMBERS STARTING WITH $Z? Y 

CONFIRM DELETE GENERIC REQUEST ON VOLUME: 
CONTINUE (Y/N)? Y 

USING VOLUME JMMOBJ 



JMMOBJ 



^ 



NAME 


TYPE 


FIRST RECORD 


SIZE 


EOD/PGMSZ 


$Z1 


DATA 




1681 




2 


NA 


DELETE? 


Y 












$Z1 


DELETED 












$Z3 


DATA 




1685 




2 


NA 


DELETE? 


Y 












$Z3 


DELETED 












$Z2 


DATA 




1683 




2 


NA 


DELETE? 


Y 












$Z2 


DELETED 














29 FREE 


RECORDS 


IN 


L 1 BRARY 




COMMAND 


(?): 
















Respond Y to the delete? prompt to delete a data set or N to cancel the delete function. 
$DISKUT1 continues prompting for each data set on the volume with the specified prefix. 

Note: NA means that the end-of-data pointer and flag in the directory member entry have not 
been set. 

DGD — Delete all Data-Type Data Sets Starting with Text 

Use the DGP command to delete all data-type data sets starting with a specific prefix. DGD 
operates in the same manner as DG except that you can only delete data-type data sets. 

DGP — Delete All Programs Starting with Text 

Use the DGP command to delete all program-type data sets starting with a specific prefix. DG? 
operates in the same manner as DG except that you can only delete program-type data sets. 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 

DNG — Delete All Data Sets Not Starting with Text 

Use the DNG command to delete all data sets (data- and program-type) not starting with a 
specific prefix. $DISKUT1 displays each data set that doesn't start with the specified prefix, then 
prompts you as shown in the example. If you do not want to be prompted for each data set, use 
the SNQ command to turn off the prompt mode. $diskuti then deletes the appropriate data sets 
without verifying them. 

Example: Delete all data sets that do not start with the prefix $z. 



COMMAND (?): DNG 
ENTER GENERIC TEXT: $Z 

DELETE ALL MEMBERS NOT STARTING WITH $Z (Y/N)? Y 

CONFIRM DELETE GENERIC REQUEST ON VOLUME : JMMOBJ 
CONTINUE (Y/N)? Y 

USING VOLUME JMMOBJ 



NAME 


TYPE 


FIRST RECORD 


SIZE 


EOD/PGMSZ 


DATAl 


DATA 




1681 




2 


NA 


DELETE 


(Y/N)? Y 












DATAl 


DELETED 












MYDATA 


DATA 




1685 




2 


NA 


DELETE 


(Y/N)? Y 












MYDATA 


DELETED 












DATA2 


DATA 




1683 




2 


NA 


DELETE 


(Y/N)? Y 












DATA2 


DELETED 














29 FREE 


RECORDS 


IN 


L 1 BRARY 




COMMAND 


(?): 













Respond Y to the delete? prompt to delete a data set and N to cancel the delete function. 
$DISKUT1 continues prompting for each data set on the volume with the specified prefix. 

Note: NA means that the end-of-data pointer and flag in the directory member entry have not 
been set. 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 

DNGD — Delete All Data-Type Data Sets Not Starting with Text 

Use the dngd command to delete all data-type data sets that do not start with a specific prefix. 
DNGD operates in the same manner as dng except you can only delete data-type data sets. 

DNGP — Delete All Programs Not Starting with Text 

Use the dngp command to delete all program-type data sets not starting with a specific prefix. 
DNGP operates in the same manner as DNG except you can only delete program-type data sets. 

EN — End the Program 

Use the EN command to end the $DISKUT1 utility. 
LA — List All Data Sets 

Use the LA command to Ust all data sets (data- and program-type) on a specific volume. 



COMMAND (: 


): LA 








USING VOLUME EDX001 








NAME 


TYPE 


FIRST RECORD 


SIZE 


EOD/PGMSZ 


LNK52 


DATA 


6i| 


98 


98 


CONV 


DATA 


165 


11 


n 


STG2 


DATA 


kQ3 


3 


NA 


STG4 


DATA 


i»26 


3 


NA 


MSGTST5A 


PGM 


383 


26 


Ik 



8864 FREE RECORDS IN LIBRARY 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 



Notes: 

1. EOD is the displacement to the next available record for data-type data sets. 

2. NA means that the system has not set the end-of-data pointer and flag in the directory 
member entry. 

To cancel a long list, press the attention key, press the enter key, and enter CA. 
LACTS — List All Data Sets in CTS/RBA Mode 

Use the lacts command to list all data sets (data- and program-type) on a specific volume. 

For the 4962 disk and the 4963 disk subsystem, the system shows the disk locations of the data 
sets in CTS format. For the 4967 disk subsystem, as well as DDSK-30 and DDSK-60 disks, the 
system shows the disk locations of the data sets in rba format. 

Example 1 : List all data sets in CTS format. Volume edxooi resides on a 4963 disk 
subsystem; the system shows the disk locations of the data set in CTS format. 






COMMAND (?): "-ACTS 

USING VOLUME EDXOOI 
NAME TYPE 



NOMSG 

EDXSTART 

LNO 



DATA 
DATA 
DATA 



ORG (CTS) 

0080007 
0030115 
0050006 



END(CTS) 

0080012 
0040106 
0050008 



FULLR PGM 0400010 0440008 
IOA6 FREE RECORDS IN LIBRARY 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



Example 2: List all data sets in RBA format. Volume EDXOOl resides on a 4967 disk 
subsystem; the system shows the disk locations of the data sets in RBA format. 



r 



COMMAND (?): LACTS 

USING VOLUME EDXOOl 
NAME TYPE 



LNK52 

CONV 

FULL 



DATA 
DATA 
PGM 



ORG(RBA) 

3331065 
3331168 
3331182 



END{RBA) 

333116A 
3331178 
3331185 



CONVP PGM 3331179 3331181 
8864 FREE RECORDS IN LIBRARY 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



LAD — List Data Sets on All Volumes 






Use the lad command to list all data sets (data- and program-type) on all volumes. You may 
only want to list data sets starting with a specific prefix. Do this by entering the lad command 
followed by the prefix. This command is useful in finding a data set when you do not know the 
name of the volume where it resides or if the same data set appears on multiple volumes. 
$DISKUT1 lists the name of each data set along with the following information: 

the type (data or program) 

the number of the first record in the data set 

the size of the data set 

the last record in a data-type data set or the number of records in a program-type data set 

the volume where it resides. 

Example: List data sets with a prefix of 'S' in all volumes. 



COMMAND 


(?): LAD 


S 










NAME 


TYPE 


FIRST 


RECORD 


SIZE 


EOD/PGMSZ 


VOLUME 


SEW 


DATA 




I6it6 


100 


79 


EDX002 


SSRC 


DATA 




77A8 


5 


5 


EDX002 


SMODUL 


DATA 




1386 


10 


10 


ASMLIB 


SWORK 


DATA 




15522 


300 


225 


EDX003 


SDATA 


DATA 




6989 


5 


5 


EDX005 



USING VOLUME EDX005 
COMMAND (?): 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 

LAV — List All Volumes 

Use the lav command to list all volumes on your Series/ 1. The lav command scans all existing 
volumes and $diskuti lists the name of each volume along with the following information: 

• the device address 

• the number of the first record on the volume 

• the size of the volume. 

When it finishes the scan, $DiSKUTi points to the last volume accessed. 
Example: 



COMMAND (?): 


LAV 








VOLUME NAME 


DEVICE 


ADDRESS 


FIRST RECORD 


SIZE 


EDX002 
ASMLIB 
MTMSRC 
TSTSRC 




0003 
0003 
0013 
0013 


361 
98^1 

361 
8761 


9480 
8000 
8400 
2200 


USING VOLUME 


EDX002 








COMMAND (?): 











k.V 



To cancel a long list, press the attention key and enter $C $diskutl This cancels the listing and 

$DISKUT1. 



o 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 



LD — List Data-Type Data Sets 



Use the ld command to list all the data-type data sets on a specific volume, the number of the 
first record in the data set, and the size of the data set. 

Example: List the data sets on volume edxooi. 

" > 

COMMAND (?): LD 

USING VOLUME EDXOOI 



NAME 


FIRST RECORD 


SIZE 


EOD/PGMSZ 


TEXTWORD 


105 


22 


22 


$SAMDATA 


127 


36 


30 


$NAME3 


450 


10 


NA 



506 FREE RECORDS IN LIBRARY 
COMMAND (?): 



Notes: 

1 . EOD is the displacement to the next available record. 

2. NA means that the system has not set the end-of-data pointer and flag in the directory 
^ member entry. 

LDCTS — List Data-Type Data Sets in CTS/RBA Mode 

Use the LDCTS command to Ust only data-type data sets on a specific volume. Depending upon 
the disk on which the volume resides, the system shows the locations of the data sets in CTS or 
RBA format. 

For the 4962 disk and the 4963 disk subsystem, the system shows the disk locations of the 
members in CTS format. For the 4967 disk subsystem, as well as DDSK-30 and DDSK-60 disks, 
the system shows the disk locations of the members in RBA format. 



Chapter 4. Utilities UT- 189 



$DISKUT1 

$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



Example 1 : List all data sets in CTS format. Volume edxooi resides on a 4963 disk 
subsystem; the example shows the disk locations of the data sets in CTS format. 



r 



COMMAND (?): LOCTS 

USING VOLUME EDXOOI 
NAME ORG (CTS) 



END(CTS) 



NOMSG 


0080007 


0080012 


EDXSTART 


0030115 


0040106 


LNO 


0050006 


0050008 



V. 



FULLR 0290105 0290108 

1046 FREE RECORDS IN LIBRARY 



Example 2: List all data sets in rba format. Volume edxooi resides on a 4967 disk 
subsystem; the example shows the disk locations of the data sets in rba format. 



r 



COMMAND (?): LDCTS 

USING VOLUME EDXOOI 
NAME ORG(RBA) 



END(RBA) 



LNK52 


3331065 


3331164 


LNK52U 


3331190 


3331289 


STG1 


3331165 


3331166 



LNK52R 3330663 3330764 
8864 FREE RECORDS IN LIBRARY 
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LISTP — Direct Listing to $SYSPRTR 



Use the LISTP command to direct all $DISKUT1 listings to the device designated as the $SYSPRTR. 
Once you specify this command, the system directs all listings to SSYSPRTR until you specify 
another device. 

Example: List all subsequent $diskuti listings to the $sysprtr. 

COMMAND (?): LISTP 
COMMAND (?): 



LISTT — Direct Listing to Terminal 



Use the LISTT command to direct all $DISKUT1 listings to the terminal that invoked $DISKUT1. 
Once you specify this command, the system directs all listings to that terminal until you specify 
another device. 

Example: List all subsequent SDISKUTI listings to the terminal that invoked $DISKUT1. 

COMMAND (?): LISTT 

COMMAND (?): LD EDX002 

USING VOLUME EDX002 

NAME FIRST RECORD SIZE EOD/PGMSZ 

2791 FREE RECORDS IN LIBRARY 
COMMAND (?): 



LM — List a Specific Data Set 



Use the lm command to list the description of a specific data set (data- or program-type). 
SDISKUTI lists the data set type, the disk location of the first record, the size of the data set and 
the EOD. The EOD is the displacement to the next available record for data-type data sets. 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



Example 1 : List the directory description of a data-type data set (member). 

For the 4962 disk and the 4963 disk subsystem, the system shows the disk location of a data set 
in CTS format. 






COMMAND (?): LM 
MEMBER NAME: TEST12 

USING VOLUME EDX001 

NAME TYPE FIRST RECORD SIZE 

TEST 12 DATA 305 7 

I0DA=003 (HEX), CTS=0220n5, 0220121 

COMMAND (?): 



EOD/PGMSZ 
5 



Notes: 

1. iODA=i/o device address; CTS=cylinder, track, and sector. In this example, the data set is 
on the device at device address 003 at cylinder 22, track 01, from sector 16 through sector 
21. 

2. FIRST RECORD is the number containing the first record of the data set. 

Example 2: List the directory description of a program-type data set (member). 

For the 4967 disk subsystems, as well as the DDSK-30 and DDSK-60 disks, the system shows 
the disk location of a data set in rba (relative block address) format. In this example, the data 
set is on the device at address 0048 at RBA 0751 100,0760107. 



o 



COMMAND (?): LM 
MEMBER NAME: $EDXNUC 

USING VOLUME EDX002 

NAME TYPE FIRST RECORD 

$EDXNUC PGM OVLY 121 

I0DA=0048 (HEX), R8A=0751 100,0760107 

COMMAND (?): 



SIZE 
400 



EOD/PGMSZ 
202 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 

Notes: 

1. lODA=i/o device address; RBA=relative block address. In this example, the data set is on 
the device at device address OOCO at relative block address 0751100. 

2, FIRST RECORD is the number containing the first record of the data set. 

LP — List Programs 

Use the LP command to list all program-type data sets on a specific volume or only those starting 
with a specified prefix. The system directs the listing to the $sysprtr. You can redirect the 
listing by specifying the label of the printer following the LP command or the prefix. For 
example, to direct the listing in the example to a printer other than $SYSPRTR, enter the 
following: 



I 



COMMAND (?): LP $DISK $SYSLOGA 



The system directs the listing, in this case, towards the printer designated as the alternate logging 
device ($sysloga). 

Example: List directory description of the program-type data sets beginning with the prefix 

$DISK. 

COMMAND (?): LP $DISK 

USING VOLUME EDX001 

NAME FIRST RECORD SIZE EOD/PGMSZ 

$DISKUT1 256 32 25 

$DISKUT2 288 30 23 

$OISKTST OVLY 323 15 10 

2550 FREE RECORDS IN LIBRARY 

COMMAND (?): 

Notes; 

1 . FIRST RECORD is the number of the first record of the data set. 

2. PGMSZ shows the size of the program in records, excluding RLDs and overlays. 

3. OVLY indicates an overlay program. 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 

LPCTS — List Program-Type Data Sets in CTS/RBA IVIode 

Use the LPCTS command to list only program-type data sets on a specific volume. Depending 
upon the disk on which the volume resides, the location of the data sets (members) are shown in 
CTS or RBA format. 

For the 4962 disk and the 4963 disk subsystem, the system shows the disk locations of the 
members in CTS format. 

For the 4967 disk subsystems, as well as DDSK-30 and DDSK-60 disks, the system shows the 
disk locations of the members in rba format. 

Example 1 : List all data sets in CTS format. Volume edxooi resides on a 4963 disk 
subsystem; the system shows the locations of the data sets in CTS format. 



COMMAND (?): LPCTS 

USING VOLUME EDXOOI 

NAME ORG(CTS) END(CTS) 

FULL 0140113 0150001 

10^6 FREE RECORDS IN LIBRARY 



Example 2: List all data sets in RBA format. Volume EDXOOi resides on a 4967 disk 
subsystem; the system shows the locations of the data sets in rba format. 






COMMAND 


(?): LPCTS 




USING VOLUME EDXOOI 
NAME ORG(RBA) 


END(R 


CONVP 
FULL 


3331179 
3331182 


3331181 
3331185 


FULLR 
T5A 


33A0635 
33^0765 


33^*0662 
33^0796 



8864 FREE RECORDS IN LIBRARY 



\J 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 



LS — List Free Space 






Use the LS command to list the free space available on a specific volume. In addition, $diskuti 
lists the following information: 

the size (in records) of the volume 

the number of unused records 

the number of directory entries 

the number of unused directory entries 

the total number of data sets 

the number of free space entries. 

$DISKUT1 then prompts if you wish to list the free space chain. Respond Y and $DISKUT1 Usts the 
size and the location (number of the first record) of each area of free space on the volume. 

Example: List free space available on volume edxooi. 



COMMAND (?): LS 
USING VOLUME EDXOOI 



LIBRARY , 




AT RECORD 


1 


SIZE 


3600 RECORDS 


UNUSED 


665 RECORDS 



DIRECTORY 

SIZE A05 MEMBERS ( 51 RECORDS) 
UNUSED 179 MEMBERS 

NUM6ER OF MEMBERS - 35 

NUMBER OF FREE SPACE ENTRIES - 2 

LIST FREE SPACE CHAIN? Y 

FIRST RECORD SIZE 
3000 600 
247 65 

COMMAND (?): 



Note: FIRST RECORD is the number of the first record within the data set. 
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$DISKUT1 - Allocate/Delete/List Directory Data (continued) 

RE — Rename a Data Set 

Use the re command to rename a data set. 

Example: Rename a data set named PROGl to myprog. 



COMMAND (?): RE 
MEMBER NAME: PROGl 
NEW NAME: MYPROG 
RENAME COMPLETED 



SE — Set End of Data Pointer/Flag 



Use the SE command to set the end-of-data pointer/flag on within a data- or program-type data 
set. 

Example: Set end of data pointer for data set named datafile. 



COMMAND (?): SE DATAFILE 

DATAFILE EOD POINTER I S NOW : 

DATAFILE EOD FLAG IS NOW OFF 

NEW EOD (-1 TO RESET EOD AND FLAG): 
ARE ALL PARAMETERS CORRECT? Y 

DATAFILE EOD POINTER I S NOW : 

DATAFILE EOD FLAG IS NOW ON 

COMMAND (?): SE DATAFILE 

DATAFILE EOD POINTER I S NOW : 

DATAFILE EOD FLAG IS NOW 

NEW EOD (-1 TO RESET EOD AND FLAG): 
ARE ALL PARAMETERS CORRECT ? Y 

DATAFILE EOD POINTER I S NOW : 

DATAFILE EOD FLAG I S NOW : 

COMMAND (?): 



2 

ON 

-1 





OFF 



-J 






Notes: 

1. RESET Option sets the eod flag off and the EOD pointer to 0. 

2. This command modifies fields within the directory member entry. It does not change the 
actual data set. 
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$DISKUT1 -Allocate/Delete/List Directory Data (continued) 



SNQ — Reset Prompt Modes 



Use the SNQ command to turn off the prompt mode for the delete generic commands (dg, dgp, 
DGD, DNG, DNGP and dngd). This means that for these commands, $diskuti deletes the data 
sets without prompting you to verify each one. If you want to turn prompt mode off, do so 
before you use any of these commands. 



L 



COMMAND (?): SNQ 



SQ — Set Prompt Modes 



Use the SQ command to set $diskuti to prompt mode for the delete generic commands. This 
means that for the DG, dpg, dgd, dng, dngp and dngd commands, $diskuti prompts you to 
verify each data set you want to delete. Prompt mode is the default for the list commands. If 
you do not want to be prompted for each data set to be deleted, use the SNQ command to turn 
off prompt mode. 

Example: 

{ COMMAND (?): SQ 
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$DISKUT2 - Patch/Dump/List Data Set or Program 

With $DISKUT2, you can perform the following operations on data sets and/or programs: 

Clear (set to zero) all or portions of a data set and reset the end-of-data pointer. 

Dump any data set created using $editin or $fsedit or any program on the terminal you are 
using or on the printer of your choice. 

Patch a data record in a data set or an address within a program. 

Modify the default load time storage allocation associated with a program. 

List the contents of a data set on the terminal you are using or on the printer of your choice. 

List the log data set associated with a specific device on the terminal you are using or on the 
printer of your choice. 

Note: For tape management functions, see "$TAPEUT1 - Tape Management" on page 

UT-522. 

Program and Data Set Member Dumps and Patches 

You make program member dumps and patches by relative address (hexadecimal) within the 
program. The relative address corresponds exactly to the address specified in the LOC field of 
an assembly listing. You can enter data in decimal, hexadecimal, or EBCDIC as shown in the 
examples that follow. 

You make data set member dumps and patches by specifying a record number and a first word. 
The numbering for both record and word number begins with 1 . You can enter data in either 
decimal, hexadecimal, or EBCDIC. You should separate each field of patch data with a 
nonnumeric character other than a carriage return. 

Note: Any patch you make to a data set or a program is permanent. Be sure that the data set 
record or program address you are patching is correct. Check a dump of the data set or the 
program assembly listing before you perform a patch. 

The system formats dumps of program or data set members when you select hexadecimal as an 
option. 



1^ \ 



o 



O 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

Absolute Record Numbers 

A special feature of $diskut2 allows dumping and/or patching of any area on a disk volume by 
referencing absolute record numbers. Select this this mode by entering the characters $$edxvol 
as a member data set name. When you use this mode, the system will direct operation to 
absolute record numbers rather than symbolic data/program member names, with record 1 
being the first physical record on the disk or diskette where the volume resides. 

If you enter the special system name $$edxlib, the system uses absolute record numbers and 
considers the first record in the directory as record 1 . $$edxvol references the first physical 
record on the disk or diskette. On diskettes, the system uses $$edxvol to reference records on 
cyUnder only (if you attempt to access other cyUnders, you will produce unpredictable results). 
You can reference all other records on diskette using $$edxlib. 

Notes: 

1. $$, $$edxvol, and $$edxlib are special system data set names. $$ is a reserved system 
name. $$edxvol points to the beginning of a volume. $$edxlib points to the beginning of 
the data set directory within a volume. 

2. When using this mode, you also have access to records that are meant for Series/ 1 hardware 
use only. For example, the system designates records 121 through 240 on the 4962 disk for 
alternate sector assignment and they are not meant to be accessed directly. 

3. When you use the du or LU commands to dump or list $$EDXVOL, you dump only the data, 
not the whole device. 

Invoking $DISKUT2 

You invoke $DISKUT2 with the $L command or option 3.2 of the session manager. 

> $L $DISKUT2 
LOADING $DISKUT2 51P ,00: 30: 15 , LP= 9200, PART=1 

$DISKUT2 - DATA SET MGMT. UTILITY II 
USING VOLUME XXXXXXX 
COMMAND (?): 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

$DISKUT2 Commands 

To display the $diskut2 commands at your terminal, enter a question mark in response to the 
prompting command command (?):. 






COMMAND (?): ? 

CD - CLEAR DATA SET 

CV - CHANGE VOLUME 

DP - DUMP DS OR PGM ON PRINTER... DP DSNAME PRTNAME 

DU - DUMP DS OR PGM ON CONSOLE 

(-CA- WILL CANCEL) 
PA - PATCH DS OR PGM 
SS - SET PROGRAM STORAGE PARM 

LP - LIST DS ON ANY PRINTER... LP DSNAME PRTNAME 
LU - LIST DS ON CONSOLE 

PL - LIST LOG ON ANY PRINTER... PL DSNAME PRTNAME 
LL - LIST LOG ON CONSOLE 

PR - LIST LOG BY WRAP COUNT AND RELATIVE RECORD ON ANY PRINTER 
LR - LIST LOG BY WRAP COUNT AND RELATIVE RECORD ON CONSOLE 
EN - END PROGRAM 

COMMAND (?): 



Note: The LR and PR commands are for remote manager (RMl) users only. 



$DISKUT2 includes the time and the date in your listing if you include timer support in your 
system and you direct output to a print device using dp, lp, pl„ or PR. You can send your output 
to any printer using the prtname parameter on the dp, lp, pl, or PR command. The default is 

$SYSPRTR. 






Note: If you dump (du) or list (lu) a data set on a terminal using $$edxvol, you are limited to 
the number of logical records. 



All the functions listed (except for ?, CV, and en) act upon the ipl volume. When you invoke 
$DISKUT2, it issues the following message: 



L 



USING VOLUME volname 



To point to another volume to perform one or more of the previously listed functions, enter the 
CV command and the name of the volume. 



I 



COMMAND (?): CV volname 
USING VOLUME volname 



\ J 

^%l^jjj^ 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



All functions act upon the specified volume until you change them with another CV command or 
until you end and reload $DISKUT2. If you specify an invalid volume a CV command, the utility 
uses the IPL volume, if it is available. If the IPL volume is not available, the system issues the 
message no volume available. You can either end the $diskut2 or change volumes using the 
CV command. 



CD 



Each command and its explanation is presented in alphabetical order on the following pages. 
Clear a Data Set (to Zeros) 



Use CD to clear an entire data set or a portion of a data set and to reset the end-of-data pointer. 
This sets the data within the data set to zero. 

Examp/e: 



r 



Ilk 



COMMAND (?): ^"^ 
OMfii SET NAME? DATA 
CLEAR ENTIRE DATA SET? ^ 
FIRST RECORD: 1 
LAST RECORD: 100 

RESET THE E.O.D. POINTER? Y 
HOW MANY RECORDS TO EOD? 100 

ARE ALL PARAMETERS CORRECT? Y 
CLEAR COMPLETED 

COMMAND (?): 



CV — Change Volume 



Use the CV command to change volumes. When you invoke $diskuT2, it assumes you are using 
the IPL volume. All $DISKUT2 functions operate on the IPL volume until you change to another 
volume. 

Examp/e: 



USING VOLUME EDX002 

COMMAND (?): CV EDX^lO 
USING VOLUME EDX40 



COMMAND (?): 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

DP — Dump a Data Set or Program on a Printer 

Use DP to dump all or portions of a data set or program to a printer. If you don't specify a 
printer, the system directs the dump to the $sysprtr. 

Example 1 : Dump a data set on a printer other than $SYSPRTR. 



COMMAND (?): DP EJWl MPRTR 

EJW1 IS A DATA SET 

FIRST RECORD (O TO CANCEL COMMAND) 

LAST RECORD: 2 

FIRST WORD: i 

WORDS/RECORDS: 12 

(D)EC, (E)BCDIC OR (H)EX: H 

DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 



Notes: 



1 . You must specify the printer name on the same line as the command and the data 
set/program. The system does not issue a prompt for the printer name. 

2. The printer name is the label on the terminal definition statement defining the printer to 
the supervisor. 



\J 



Example 2: Dump a portion of a program on $sysprtr. 



COMMAND (?): DP 

PGM OR DS NAME: MYPROG 

MYPROG IS A PROGRAM OF HEX SIZE 0000026C 

ADDRESS: 0000 

DUMP TO PROGRAM END? N 

HOW MANY WORDS? 20 

0000 0008 0709 D6C7 D9C1 D^^tO 0000 OlB^t 025^ 

0010 0000 0000 0258 0000 0000 0000 0100 0256 

0020 0000 0000 0000 0000 

DUMP COMPLETE 
ANOTHER AREA? N 
COMMAND (?): 



I ..PROGRAM ...M..| 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



DU — Dump a Data Set or Program on Terminal 



Use the DU command to dump all or a portion of a data set or a program to the terminal where 
you invoked $diskut2. 

Example 1 : Dump a portion of a data set on the terminal. 

COMMAND(?): ^^ 

PGM OR DS NAME: EDITWORK 

EDITWORK IS A DATA SET 

FIRST RECORD (0 TO CANCEL COMMAND) 

LAST RECORD: 



1 



FIRST WORD: 



WORDS / RECORD: 52 

(D)EC, (E)BCDIC, OR (H)EX: 



RECORD 1 

1 7A2E 

9 0000 

17 0000 

25 0000 

33 0000 

^1 7896 

49 7BA4 



78D0 
0000 
0000 
0000 
0000 
A02F 
6808 



0088 
34D6 
14D0 
0000 
0000 
7BA0 
00F6 



7A30 OOOA 101A 
0000 0000 0000 
5600 0000 7A02 
0000 0000 0000 
0000 5040 6F03 
0000 182C 6808 
680D 



D2A0 4040 
0000 FFFF 
0000 0000 
0000 0000 
023C 0254 
00C4 680D 



,6. 



DUMP COMPLETE 
ANOTHER AREA? 
COMMAND (?): 



Example 2: Dump a portion of a program on the terminal. 



r 



COMMAND {?): °^ 

PGM OR DS NAME: EX31DS02 

EX31DS02 IS A PROGRAM OF 

ADDRESS: 100 

DUMP TO PROGRAM END? ^ 



HEX SIZE OO0O3B7E 



HOW MANY WORDS? 



20 



0100 C4C1 E3C1 F0F2 4040 0606 C4C9 E2D2 F0F2 |DATA02 

0110 0000 0000 0000 0000 0001 0000 0001 0000 I 

0120 0000 0000 0000 0000 I 



.DISK02I 



DUMP COMPLETE 
ANOTHER AREA? ^ 

COMMAND (?): 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

Example 3: Dump a portion of a program with overlay segments on the terminal. 



COMMAND (?): DU 

PGM OR DS NAME: EX31ES01 

EX31ES01 IS A PROGRAM OF HEX SIZE 000O2FA8 WITH 2 OVERLAY SEGMENTS 

ADDRESS: 100 

HOW MANY WORDS? 10 

0100 0000 00B2 C026 2221 7CC4 D640 E8D6 E4i*0 | @D0 YOU | 

0110 E6C1 D5E3 |WANT | 

DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 



Example 4: Dump an overlay segment of a program on a terminal. 



r 



COMMAND (?): DU EX31ES01 

EX31ES01 IS A PROGRAM OF HEX SIZE 00002FA8 WITH 2 OVERLAY SEGMENTS 

ADDRESS: 2FO0 

DUMP OVERLAY SEGEMENT (0) OR RESIDENT CODE (R)? 

WHICH OVERLAY? 2 

HOW MANY WORDS? 10 

0258 3232 C9D5 C^tCS D7C5 05^4 C5D5 E3^0 D709 | .. INDEPENDENT PR| 
0268 D6C7 D9C1 JOGRA | 

DUMP COMPLETE 
ANOTHER AREA? N 



COMMAND (?): 



V 






Note: Addresses within an overlay segment are relative to the beginning of that overlay 
segment. 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 5: Dump a portion of the supervisor that is located in an overlay area. 

COMMAND (?): DU 

PGM OR DS NAME: $EDXNUCC 

ENTER PARTITION NUMBER(l-8) : 1 

PARTITION 1 OF $EDXNUCC HAS A HEX SIZE OF 0000D9FF WITH 3 OVERLAY SEGMENTS 

ADDRESS: DOOO 

DUMP OVERLAY SEGMENT (0) OR RESIDENT CODE (R)? 

WHICH OVERLAY? 2 

HOW MANY WORDS? 3 



0304 



10A2 0^*20 Oi»1E 



|.- 



V. 



DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 



^T>aiiiiii 



Example 6: Dump a portion of a supervisor with overlay segments. The portion you are 
dumping does not reside within the overlay segment. 



r 



COMMAND (?): DU 

PGM OR DS NAME: $EDXNUCC 

ENTER PARTITION NUMBER(l-8) : 1 

PARTITION 1 OF $EDXNUCC HAS A HEX SIZE OF 0000D9FF WITH 3 OVERLAY SEGMENTS 

ADDRESS: DOOO 

DUMP OVERLAY SEGMENT (0) OR RESIDENT CODE (R) ? R 

HOW MANY WORDS? 3 



DOOO 



0000 0000 0000 



I- 



DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 7: Dump a portion of a supervisor not located within an overlay area. 

COMMAND (?): DU 

PGM OR DS NAME: SEDXNUCC 

ENTER PARTITION NUMBER(l-8): 1 

PARTITION 1 OF $EDXNUCC HAS A HEX SIZE OF 0000D9FF WITH 3 OVERLAY SEGMENTS 

ADDRESS: 9000 

HOW MANY WORDS? 3 

9000 0000 000^ 8C60 | . . 

DUMP COMPLETE 
ANOTHER AREA? N 

COMMAND (?): 



You can use single-line entry; however, be sure to enter the information required in the order 
that the $diskut2 expects it. Here is the information for the above example entered in 
single-line entry: 



l 



COMMAND (?): DU $EDXNUCC 1 9000 3 



EN — End $DISKUT2 

Use EN to end $diskut2. 

Example 



.^"^ 



V 



COMMAND (?): EN 

SDISKUTZ ENDED AT 00:36:0't 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

LL — List Log Data Set for a Specific Device on a Terminal 

Use LL to list the log data set for a specific device on the terminal where you invoked $DISKUT2. 

Example: List log data set for device at address 002 on the terminal. (Refer to the Problem 
Determination Guide for an explanation of the log output.) 



r 






COMMAND (?): LL 

LOG DS NAME: $LOGDS 

ENTER DEVICE ADDRESS, NULL FOR ALL ENTRIES, 

OR 'FFFF' FOR PROGRAM/SYSTEM CHECKS ONLY: 002 
ERROR LOG LIST, DATA SET: LOGOS ON EDX002 
ADDR: 0002 
I/O LOG ERROR COUNTERS (BY DEVICE ADDR): 

0000 0000 0200 0000 0000 0000 0000 0000 0000 
0010 0000 0000 0000 0000 0000 0000 0000 0000 
0020 0000 0000 0004 0000 0000 0000 0000 0000 



OOEO 
OOFO 



0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 



SOFT RECOV. ERR 
DEV ADDR: 0002 
DATE: 7/ 7/80 
11:13:20 
0012 



TIME: 

INTCC 

DCB1 

DCB2 

DCB3 

CSSW 



DEV ID: 
LVL: 0001 
RETRY: 3 
I SB: 0080 



0106 

AKR: 0000 
IDCB: 7002 0874 



8007 0000 0000 0000 0000 0884 0000 0000 
8005 0001 0000 0001 0000 0894 0000 0000 



2009 0000 0000 0001 
08A3 0400 0001 0001 



0001 0000 0100 CBEE 






Chapter 4. Utilities UT-207 



$DISKUT2 

$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

LP — List All or a Portion of a Data Set on Printer 

Use LP to list all or a portion of a data set on the printer. If you do not specify a printer, the 
system directs the hst to the $sysprtr. 

Example 1 : List a data set on a printer other than $sysprtr. 



COMMAND (?): LP CS MPRTR 
LIST ALL OF THE DATA SET? Y 

COMMAND (?): 



i 



Notes: 

1 . You must specify the printer name on the same line as the command and the data 
set/program. The system does not issue a prompt for the printer name. 

2. The printer name is the label on the TERMINAL definition statement defining the printer to 
the supervisor. 



Example 2: List a portion of a data set on $sysprtr. 

COMMAND (?): LP 

DATA SET NAME? MYPROG 

LIST ALL OF THE DATA SET? N 

FIRST RECORD: 1 

LAST RECORD: 20 

LIST COMPLETE 

. COMMAND (?): 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

LR — List Log by Wrap Count and Relative Record for a Specific Device on a Terminal 

Use LR to list the log by wrap count and relative record on the terminal where you invoked 

$DISKUT2. 

Example 1 : List log by wrap count and relative record on current' terminal. (Refer to the 
Problem Determination Guide for an explanation of the log output.) 






r 



COMMAND (?): LR 

LOG DATA SET (NAME .VOLUME) : $LOGDS ,EDX002 

ENTER (HEX) WRAP COUNT AND RELATIVE 

RECORD NUMBER IN THE FORM WWWW RRRR: 0001 0001 



SOFT 


RECOV. ERR 








DEV ADDR: 0002 




DEV ID: 0106 




DATE: 12/10/83 




LVL: 0001 AKR: 


0000 


TIME: 11:10:20 




RETRY: 3 IDCB: 


7002 


INTCC: 0012 




ISB: 0080 




DCB1 


8007 0000 


0000 


0000 0000 0884 0000 


0000 


DCB2 


8005 0001 


0000 


0001 0000 0894 0000 


0000 


DCB3 


2009 0000 


0000 


0001 0001 0000 0100 


CBEE 


CSSW 


08A3 0400 


0001 


0001 





0874 



When your log data set is exactly filled, $LOG increments its wrap count by one even if there is 
no data after the wrap. The header, therefore, shows a wrap with no data. In this situation, 
specify the previous wrap count number. By doing so, you dump the entire data set. 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 2: In the following example of a log eight records long, two are control records and 
six are data records. $L0G writes to the end of the data set and sets the wrap count to two. No 
more data is written. 



f 



r 



K 



COMMAND (?): LR 

LOG DATA SET (NAKE .VOLUME ) : SLOGDS ,EDX002 

ENTER (HEX) WRAP COUNT AND RELATIVE 
RECORD NUMBER IN THE FORM WWWW RRRR: 2 

■'■"" LOG DATA SET WRAP COUNT IS 0002 HEX 
'•"" NO DATA WAS WRITTEN AFTER THE LAST WRAP 
'•"" ENTER PREVIOUS WRAP COUNT - 0001 HEX 

ENTER (HEX) WRAP COUNT AND RELATIVE 
RECORD NUMBER IN THE FORM WWWW RRRR: 1 

""" RELATIVE RECORD OUT OF RANGE. 

*"" ALLOWABLE RECORDS ARE 0001 - 0006 HEX 

ENTER (HEX) WRAP COUNT AND RELATIVE 
RECORD NUMBER IN THE FORM WWWW RRRR: 1 6 



LU — List Contents of a Data Set on Terminal 

UseLU to Ust all or a portion of a source data set on the terminal where you invoked $DISKUT2. 
Example: List a portion of a data set. 



^■■x 

W M 



r 



COMMAND(?): LU 

DATA SET NAME? CALSRC 

LIST ALL OF THE DATA SET? N 

FIRST RECORD: ^ 

LAST RECORD: 8 

ATTNLIST ATTNLIST (STOP ,P0ST1 ,CALC , P0ST2) 
SPACE 1 

KBEVENTJ 



POSTl 


POST 




ENDATTN 




SPACE 1 


LIST COMPLETE 


COMMAND 


(?): 



Ijr 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



PA — Patch a Data Set or Program 



Use PA to patch a data set record(s) or an area within a program in decimal, EBCDIC, or 
hexadecimal. 

Example 1 : Patch a data set in decimal. 

COMMAND {?): PA ASMOBJ 

ASMOBJ IS A DATA SET 

FIRST RECORD (0 TO CANCEL COMMAND): 2 

FIRST WORD: 3 

HOW MANY WORDS? ^ 

(D)EC, (E)BCDIC OR {H)EX? ^ 

NOW IS: 

3 16 

ENTER DATA: 1^ 



NEW DATA: 
3 



1! 



OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? ^ 

COMMAND (?): 



Example 2: Patch a data set in EBCDIC. 



COMMAND (?): PA ASMOBJ 

ASMOBJ IS A DATA SET 

FIRST RECORD (0 TO CANCEL COMMAND): 2 

FIRST WORD: 3 

HOW MANY WORDS? ^ 

(D)EC, (E)BCDIC OR (H)EX? ^ 



NOW IS: 
3 



0012 
ENTER DATA: 00^° 



NEW DATA: 
3 



FOFO 



V. 



OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? ^ 

COMMAND (?): 



J 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 3: Patch a data set in hexadecimal. 



COMMAND (?): PA ASMOBJ 

ASMOBJ IS A DATA SET 

FIRST RECORD (0 TO CANCEL COMMAND): 

FIRST WORD: 3 

HOW MANY WORDS? ^ 

(D)EC, (E)BCDIC OR (H)EX? H 

NOW IS: 



"N 



3 


0000 


0000 


0000 


0030 


ENTER DATA: 


0002 


0003 


0004 


OOOA 


NEW DATA: 
3 


0002 


0003 


000^+ 


OOOA 


OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 








COMMAND (?): 











Example 4: Patch a program in decimal. 



COMMAND (?): PA 

PGM OR DS NAME: MYPROG 

MYPROG IS A PROGRAM OF HEX SIZE 0000 13FE 

ADDRESS: 02D8 

HOW MANY WORDS? 1 

(D)EC, (E)BCDIC, OR {H)EX?: D 

NOW IS: 
02D8 8 

ENTER DATA: 6 

NEW DATA: 
02D8 6 

OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 

COMMAND (?): 



f^ '^ 



o 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

Example 5: Patch a program in EBCDIC. 



J 



COMMAND (?): PA 

PGM OR DS NAME: MYPROG 

MYPROG IS A PROGRAM OF HEX SIZE 000013FE 

ADDRESS: 2D8 

HOW MANY WORDS? 7 

(D)EC, (E)BCDIC, OR (H)EX?: E 

NOW IS: 
02D8 Di»C5 D4C2 C5D9 kQZk C5D3 C5.. •• 

ENTER DATA: DELETE MEMBER® 

NEW DATA: 
02D8 C4C5 D3C5 E3C5 40D4 C5Di« C2.. .. 

OK? Y 

PATCH COMPLETE 

ANOTHER PATCH? N 

COMMAND (?): 



^ 



I MEMBER DELETE© 



DELETE MEMBER® 



Example 6: Patch a program in hexadecimal 

r 



COMMAND (?): PA EX31DS02 

EX31DS02 IS A PROGRAM OF HEX SIZE 00003B7E 

ADDRESS: 37B 

HOW MANY WORDS? 3 

(D)EC, (E)BCDIC, OR (H)EX?: H 



NOW IS 
037A 



J 



0000 0001 005D 

ENTER DATA: 0020 0003 005F 

NEW DATA: 
037A 0020 0003 005F 

OK? Y 

PATCH COMPLETE 
ANOTHER PATCH? N 

COMMAND (?): 



Chapter 4. Utilities UT-2 1 3 



$DISKUT2 

$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 7: Patch a program with overlay segments. 

r :-■--: ■■ - .■ ^- ■■■: — ^— — — 

COMMAND (?): PA EX31ES01 

EX31ES01 IS A PROGRAM OF HEX SIZE 00002FA8 WITH 2 OVERLAY SEGMENTS 

ADDRESS: : 2F32 

PATCH OVERLAY SEGMENT (0) OR RESIDENT CODE (R)? 

WHICH OVERLAY? 1 



>k 



HOW MANY WORDS? 2 
(D)EC, (E)BCDIC, OR (H)EX?: 

NOW IS: 
028A 0001 009A 

ENTER DATA: 0002 009B 

NEW DATA: 
028A 0002 009B 

OK? Y 
PATCH COMPLETE 
ANOTHER PATCH? N 

^OMMAND (?): 



H 



Note: Addresses within an overlay segment are relative to the beginning of that overlay 
segment. 

Example 8: Patch a portion of the supervisor that resides in an overlay area. 

COMMAND (?): PA 

PGM OR DS NAME: $EDXNUCQ 

ENTER PARTITION NUMBER(l-8): 1 

PARTITION 1 OF $EDXNUCC HAS A HEX SIZE OF 0000D9FF WITH 3 OVERLAY SEGMENTS 

ADDRESS: DOOO 

PATCH OVERLAY SEGMENT (O) OR RESIDENT CODE (R)? 

WHICH OVERLAY? 2 

HOW MANY WORDS? 3 

(D)EC, (E)BCDIC, OR (H)EX?: X 



|... 



O 



NOW IS: 
0304 


10A2 


0420 


04 IE 


ENTER DATA: 








NEW DATA: 
0304 


0000 


0000 


0( 


DOO 


OK? N 
ANOTHER PAl 


TH? 


N 







COMMAND (?) 



o 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 9: Patch a portion of the supervisor that resides in partition 2. 



COMMAND (?): PA 

PGM OR DS NAME: $EDXNUC(i 

ENTER PARTITION NUMBER(l-8): 2 

PARTITION 2 OF $EDXNUC(i HAS A HEX SIZE OF 000028FE 

ADDRESS: 30 

HOW MANY WORDS? 2 

(D)EC, (E)BCDIC, OR (H)EX?: X 



V 



NOW IS: 






0030 


40EF 


0020 


ENTER DATA 






NEW DATA: 






0030 


0000 


0000 


OK? N 







A 






You can use single-line entry; however, be sure to enter the information required in the order 
that the $DISKUT2 expects it. Here is the information for the above example entered in 
single-line entry: 

ANOTHER PATCH? Y 2 30 2 X 

NOW IS: 
0030 40EF 0020 I I 

ENTER DATA: 

NEW DATA: 
0030 0000 0000 I I 

OK? Y 

ANOTHER PATCH? N 

COMMAND (?): 



o 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



PL — List Log Data Set for a Specific Device on a Printer 



\J 



Use PL to list the log data set for a specific device or all devices on the printer of your choice, 
you do not specify a printer, the system directs the Ust to the $sysprtr. 



If 



Example 1: List the log data set for device 002 on the $sysprtr. 
Determination Guide for an explanation of the log output.) 



(Refer to the Problem 



COMMAND (?): PL 
LOG DS NAME: $LOGDS 

ENTER DEVICE ADDRESS, NULL FOR ALL ENTRIES 
OR 'FFFF' FOR PROGRAM/SYSTEM CHECKS ONLY: 
ERROR LOG LIST, DATA SET: LOGDS ON EDXOOZ 
ADDR: 0002 
I/O LOG ERROR COUNTERS (BY DEVICE ADDR): 



002 



0000 
0010 
0020 



OOEO 
OOFO 



0000 0200 0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 0004 0000 0000 0000 0000 0000 



0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 



SOFT RECOV. ERR 
DEV ADDR: 0002 
DATE: 
TIME: 
NTCC 



DCB1 
0CB2 
DCB3 
CSSW 



DEV ID: 0106 
7/ 7/80 LVL: 0001 AKR: 0000 
11:13:20 RETRY: 3 IDCB: 7002 0874 
0012 I SB: 0080 

8007 0000 0000 0000 0000 0884 0000 0000 

8005 0001 0000 0001 0000 0894 0000 0000 

2009 0000 0000 0001 0001 0000 0100 CBEE 

08A3 0400 0001 0001 



c 



-V 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



Example 2: List the log data set for device 002 on a printer other than $sysprtr. 



r 



COMMAND (?): PL $LOGDS MPRTR 
DEVICE ADDRE2S(NULL FOR ALL): 002 

ERROR LOG LIST, DATA SET: LOGDS ON EDX002 

ADDR: 0002 

I/O LOG ERROR COUNTERS (BY DEVICE ADDR): 

0000 0000 0200 0000 0000 0000 0000 0000 0000 
0010 0000 0000 0000 0000 0000 0000 0000 0000 
0020 0000 0000 000^ 0000 0000 0000 0000 0000 



OOEO 0000 0000 0000 0000 0000 0000 0000 0000 
OOFO 0000 0000 0000 0000 0000 0000 0000 0000 



DEV ID: 0106 

AKR: 0000 

IDCB: 7002 0874 



SOFT RECOV. ERR 

DEV ADDR: 0002 

DATE: 7/ 7/80 LVL: 0001 

TIME: 11:13:20 RETRY: 3 

INTCC: 0012 ISB: OOBO 

DCB1: 8007 0000 0000 0000 0000 0884 0000 0000 

DCB2: 8005 0001 0000 0001 0000 0894 0000 0000 

DCB3: 2009 0000 0000 0001 0001 0000 0100 CBEE 

CSSW: 08A3 0400 0001 0001 



Notes: 

1. You must specify the printer name on the same line as the command and the program name. 
The system does not issue a prompt for the printer name. 

2. The printer name is the label on the terminal definition statement defining the printer to 
the supervisor. 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 

PR — List Log by Wrap Count and Relative Record for a Specific Device on a Printer 

If you are a remote manager user (RMl), use PR to list the log wrap count and relative record for 
a specific device or all devices on the printer of your choice. If you do not specify a printer, the 
system directs the list to $sysprtr. 

Example: List log by wrap count and relative record on $sysprtr. (Refer to the Problem 
Determination Guide for an explanation of the log output.) 






COMMAND (?): PR 

LOG DATA SET (NAME .VOLUME ) 



$L0GDS,EDX002 



ENTER (HEX) WRAP COUNT AND RELATIVE 
RECORD NUMBER IN THE FORM WWWW RRRR; 



0001 0001 



ERROR LOG LIST, DATA SET: $LOGDS ON EDX002 FOR WRAP COUNT: 0001 

AND RECORD # 0001 



SOFT RECOV. ERR 
DEV ADDR: 0002 
DATE: 12/10/83 
11: 10:20 
0012 



TIME: 

INTCC 

DCBl 

DCB2 

DCB3 

CSSW 



DEV ID: 0106 
LVL: 0001 AKR: 0000 
RETRY: 3 IDCB: 7002 0874 
I SB: 0080 



8007 0000 0000 0000 0000 0884 0000 0000 
8005 0001 0000 0001 0000 0894 0000 0000 
2009 0000 0000 0001 0001 0000 0100 CBEE 
08A3 0400 0001 0001 



V, 



If you enter an incorrect wrap count for PR or lr, the system displays the following message: 



r-* INCORRECT WRAP COUNT SPECIFIED. 

LOG DATA SET WRAP COUNT IS 0001 HEX. 



If you enter an invalid record number, the system displays the following message: 



RELATIVE RECORD OUT OF RANGE. 
ALLOWABLE RECORDS ARE 0001 - 0007 HEX, 



\J 
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$DISKUT2 - Patch/Dump/List Data Set or Program (continued) 



SS — Set Program Storage Parameter 



Use SS to modify the default load time storage allocation associated with a program. You can 
change the allocation without reassembling the source code or providing an override on the 
LOAD instruction. SS requires that you express the size in bytes in decimal. The system rounds 
up the value you request if it is not an even multiple of 256. 

Example: Reduce the dynamic storage you want allocated for the COBOL compiler at program 
load. 



> $L $DISKUT2 
LOADING $DISKUT2 



$DISKUT2 



51P, 01:30:15, LP= 9200, PART=1 
DATA SET MGMT, UTILITY II 



USING VOLUME EDX002 
COMMAND (?): ^V ASML I B 
USING VOLUME ASML I B 

COMMAND (?): SS $COBOL 

ENTER NEW STORAGE SIZE IN BYTES: 28l6 

OLD STORAGE SIZE WAS 8448 

NEW SIZE WILL BE 28l6 

OK TO CONTINUE? ^ 

COMMAND (?): EN 

$DISKUT2 ENDED AT 01:32:02 
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$DIUTIL- Maintain Partitioned Data Base 



4l J' 



$DIUTIL maintains a disk-resident partitioned data base. This utility provides comprehensive 
facilities to keep the data base current by means of the following functions: 

InitiaUze the Disk-Resident data base. 

Delete a member. 

Reclaim space in the data base due to deleted members. 

Display contents of data base. 

Copy the data base. 

Copy individual members of the data base. 

Allocate and build a data member. 

Normally, you use $diutil only when no other programs of the display processor are in use. 
You can change the online data base or you may select another data base for the system to 
reference. This allows you to create displays in a data base other than the online data base and 
then copy the members into the online data base after testing. 



Invoking $DIUTIL 



You invoke $diutil with the $L command or option 5.1 of the session manager. To start 
execution of $diutil: 

1 . Load $DIUTIL specifying the appropriate data set. You can use $DIFILE, the online data set, 
or any other data set. However, be sure that another user or program is not changing or 
using the same data set. 



> $L $DIUTtL 
DISPLIB (NAME, VOLUME): 






2. The system responds with the program-loaded message followed by: 



DISPLAY DATA BASE UTILITY 
.COMMAND (?): 
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$DIUTIL- Maintain Partitioned Data Base (continued) 



$DIUTIL Commands 



To display the $DIUTIL commands at your terminal, enter a question mark in reply to the 
prompting message COMMAND (?):. 

, ^ 

COMMAND (?): ? 

AL - ALLOCATE DATA MEMBER 

BU - BUILD DATA MEMBER 

CP - COMPRESS DATA BASE 

CM - COPY MEMBER 

DE - DELETE A MEMBER 

EN - EXIT PROGRAM 

IN - INITIALIZE DATA BASE 

LA - DISPLAY MEMBER DIRECTORY 

LH - DISPLAY MEMBER HEADER 

MD - MOVE DATA BASE 

RE - RENAME MEMBER 

ST - DISPLAY DATA SET STATUS 

» COMMAND (?): ; 

After $DIUTIL displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, al). 






\ AL — Allocate Data Member 



Use the al command to reserve space in a data base for one of several types of data members. 
The system requests information such as size in sectors and member codes. Member codes are 
specified as follows: 

4 — Print Report Data Member: The system requests information such as number of lines and 
line length. It then enters each line, limited to 132 characters each. 

5 — Plot Curve Data Member: The system requests information such as x and Y ranges, x and 
Y base values, and number of points it must plot. You can select automatic entry of the X points 
to reduce the data entry requirements. The system provides a sawtooth pattern option to shade 
under the curve for more vivid presentation of plotted data. Using fewer than 200 points on the 
X axis gives an inadequate shading effect. 
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$DIUTIL- Maintain Partitioned Data Base (continued) 



6 ~ Realtime Data Member: The system requests the number of records. You can enter 
hexadecimal data for testing. 

7 thru 9 — User Data Member: The build function uses these codes to guide you through the 
correct data entry procedure. 



COMMAND {?): AL 

MEMBER NAME: TDATA 

ENTER # OF RECORDS TO ALLOCATE? 

ENTER MEMBER CODE #: k 

MEMBER TDATA ALLOCATED 

COMMAND (?): 



BU — Build Data Member 



Use the BU command to insert fixed data into a data member. This command allows you to 
enter data records to describe a fixed display or enter records, which normally will be dynamic, 
with a fixed value, to allow testing of the display. 

You may have allocated the member using AL; if not, the system prompts you for the allocation 
information it requires before it proceeds with the :"build:" process. The system guides you one 
step at a time through the initialization of the data member. 



r 



COMMAND (?): BU 

ENTER MEMBER NAME: RDATA 

INITIALIZE REPORT DATA MEMBER 

ENTER # OF LINES IN REPORT: 2 

LINE LENGTH=32 

ENTER LINE ITEMS 

LINE ONE OF REPORT 

LINE TWO OF REPORT 

MEMBER LOADED 



v: 



COMMAND (?): 



y 



In this case, the member was already allocated. 



\J 
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$DIUTIL- Maintain Partitioned Data Base (continued) 

CP — Compress Data Base 

Use the CP command to reclaim unused space in the data base. The system actually does not 
remove deleted members; it merely flags the space as unusable until you compress it. Then the 
system moves other members into that space and displays a message after each member it 
moves. When the system completes the compress, it displays the following message: 

COMPRESS COMPLETED 






You should exercise caution in using this function as it actually rearranges the members in the 
data base. To prevent unpredictable results, you should restrict your use of the interpreter 
($DIINTR) during this process. 



Note: If an unrecoverable I/O error occurs, it destroys the data set. 



r 



COMMAND (?): CP 
WARNING--COMPRESS IN PLACE, 
SHOULD OCCUR DATA SET WILL 
DO YOU WISH TO PROCEED? 



IF AN ERROR 
BE DESTROYED 
Y 



DATA 

RDATA 

REPORT 

SQUARE 

CIRCLE 

RPT 

ARC 

PLOT 

COMPRESS 

COMMAND (?) 



COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COMPLETED 



^ 



CM — Copy Member 



Use the CM command to copy a member from the source data base to the target data base. The 
options available under MD (move data base) are also available under CM (copy member). 



COMMAND (?): CM 

SOURCE DATA SET NAME: $DIFILE 

LOCATED ON VOLUME: EDX002 

CHANGE SOURCE DATA SET? N 

TARGET (NAME, VOLUME): $D I F I LE .EDX003 

SAVE EXISTING MEMBERS IN TARGET DATA BASE? 

ENTER MEMBER NAME TO BE COPIED 

PLOT 

PLOT COPIED 

COPY COMPLETED 



V. 



COMMAND (?) 






Chapter 4. Utilities UT-223 



$DIUTIL 

$DIUTIL - Maintain Partitioned Data Base (continued) 

DE — Delete a Member 

Use the de command to remove display or data members from the data base. The system 
prompts you for the name of the member you want to delete and asks you to verify the accuracy 
of your entry prior to actual deletion. 



COMMAND (?): DE 
MEMBER NAME: PLTT 
DELETE MEMBER PLTT? 
PLTT DELETED 

COMMAND (?): 



EN 



Exit Program 

Use the en command to terminate the $DIUTIL utility. 
IN — Initialize Data Base 

Use the in command to format the entire data base to zeros and to format the directory to 
reflect the starting and ending record numbers. The system prompts you to proceed. 



Note: This function destroys any data in the data base. 

Make sure you enter the correct data set name. IN ends when the system displays the message 
DATA SET FORMATTED. You allocated $DIFILE with $DISKUT1 Each directory record allocated 
with IN contains 16 directory entries, except the first, which contains 15. 






r 



COMMAND (?): 
-WARNING THI 



IN 



FUNCTION WILL DESTROY ANY DATA 

CURRENTLY IN DATA SET-' 



DO YOU WISH TO PROCEED? Y 
ENTER DIRECTORY SIZE IN RECORDS; 
DATA SET FORMATTED 
DATASET NAME: $DIFILE 
LOCATED ON VOLUME: EDX002 
- DATA SET -- DIRECTORY- 
NEXT TOTAL NEXT TOTAL 
3 TOO 1 31 

END OF STATUS 

COMMAND (?): 
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$DIUTIL- Maintain Partitioned Data Base (continued) 

LA — Display Directory 

Use the la command to display all active members. Each line of display shows the member 
name followed by four values: 

1. Starting sector relative to the start of the data base. 

2. Length of member in records. 

3. Member usage code. 

4. User-defined member code. 



Mutr 



K. 



COMMAND (? 


): LA 








PLOT 


11 


h 


2 





DATA 


15 


10 


5 





RDATA 


25 


10 


k 





REPORT 


35 




1 





SQUARE 


36 




2 





CIRCLE 


38 




2 





RPT 


39 




1 





ARC 


AO 




2 





COMMAND (: 


): 









LH — Display Member Header 



Use the lh command to display the header of a data member (types 4-9). The header describes 
the characteristics and use of the member. 

Example: 



COMMAND (?): LH 
MEMBER NAME: RDATA 
MEMBER RDATA HEADER 


END OF HEADER 



V. 



COMMAND (?) 



32 



80 
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$DIUTIL - Maintain Partitioned Data Base (continued) 

MD — Move Data Base 

Use the MD command to move the data base on the same or another volume when the data base 
becomes too small to add a member. You can move the online data base to another location 
temporarily, delete the old version, reallocate and initialize the new expanded version, and move 
back the previous contents. During this procedure, use the Interpreter with care. 

Note: If you are moving the data base and the Interpreter uses a member, you will get 
unpredictable results. 



During the execution of MD, the system prompts you for a new source data if you want one and 
a target data base. You have the option of saving the members in the target data base. MD is 
helpful if you wish to use $dicomp to develop display members in a different data base than the 
online version and then, at a later time, combine the new members with those in the online data 
base. 



r 



COMMAND (?): MD 
SOURCE DATASET NAME: 
LOCATED ON VOLUME: 



$DIFI 
EDX002 



LE 



CHANGE SOURCE DATASET? 
TARGET (NAME .VOLUME): 
SAVE EXISTING MEMBERS 



$DIFILE,E0XOO3 
N TARGET DATA BASE? 



PLOT 

DATA 

RDATA 

REPORT 

SQUARE 

CIRCLE 

RPT 

ARC 



COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 
COPIED 



COPY COMPLETED 
.COMMAND {?): 



/if *\ 
( 1 
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$D1UTIL - Maintain Partitioned Data Base (continued) 



RE — Rename Member 



Use the RE command to change the display profile id name. The system prompts you for each 
step and takes no action until it obtains your response first, RE is useful when you need to 
modify an online member. You can copy the member that needs changing to another data base, 
modify and test it, then rename it and copy it back to the onUne data base. By using the rename 
and delete functions, you can exchange the new for the old without interfering with any online 
functions. 



COMMAND (?); RE 
MEMBER NAME: PLOT 
ENTER NEW NAME: PLTT 
RENAME COMPLETED 



^ 



COMMAND (?) 



ST — Display Data Base Status 






Use the ST command to display the current data base status. The first line shows the data base 
location and name. The data that follows is the current status of the data base. There are four 
values presented. The first is the next available record. The second is the total number of 
records in the data base. You can see then how much space is available for new members. If 
space is running short, you can compress the data base or allocate a larger area. The next value 
displayed is the next available directory entry. The last value displayed is the total number of 
directory entries available. Refer to these two values to determine if you need more or less 
space for directory entries. Following the completion of the status display, the system displays a 
message indicating end-of-status. 



COMMAND (?): ST 
DATASET NAME: $DIFILE 
LOCATED ON VOLUME: EDX002 
- DATA SET -- DIRECTORY- 
NEXT TOTAL NEXT TOTAL 
41 TOO 10 159 



END OF STATUS 
COMMAND (?): 
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$DUMP - Format and Display Saved Environment 

$DUMP displays on a terminal or printer the contents of the data set generated by the STRAP 
utiUty or stand-alone dump facility. After the successful execution of $trap and the subsequent 
occurrence of a trap condition, the data set assigned to strap or the stand-alone dump will 
contain a storage image. Use $dump to retrieve, format, and print the data on a terminal or 
printer. The Problem Determination Guide shows how to interpret the output of $DUMP. 

Notes: 

1 . To print the contents of a stand-alone dump or $trap diskette that you created with $dasdi, 
use the data set and volume name $$EDXLIB,IBMEDX. 

2. Taking a stand-alone or STRAP dump allows you to dump unmapped as well as mapped 
storage. 

3. You can specify a partial dump of mapped storage but not of unmapped storage. 

invoking $DUMP 

You invoke $dump with the $L command or option 9. 1 of the session manager. 

Example: Partial dump of partition 3 to printer using $TRAP output. 



r 



> $L $DUMP 

DUMPDS(NAME, VOLUME): DUMP,EDX003 
LOADING $DUMP 22P, 12:20: 17 , LP=8F00, PART=1 

ENTER DEVICE NAME FOR OUTPUT: $SYSPRTR 
USING $TRAP OUTPUT 

PARTIAL DISPLAY (Y/N)? Y 
FORMAT CONTROL BLOCKS (Y/N)? Y 

DUMP MAPPED STORAGE (Y/N)? Y 

VALID PARTITIONS ARE 

1, 2, 3, ^, 5, 6, 7, 8, 9, 10, 11. 12, 13, 1^, 15, 16 

ENTER PARTITIONS # : 3 



IQ 



ENTER START AND ENDING ADDRESS IN HEX (2 WORDS) 
ANOTHER MAPPED AREA (Y/N)? N 
DUMP UNMAPPED STORAGE (Y N)? N 
ANOTHER AREA (Y/N)? N 



itOO 500 






m it) 
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$DUMP 

$DUMP - Format and Display Saved Environment (continued) 

Q The data set you specify here must be the same as the one you defined when you 
executed STRAP. 

Q You can specify a terminal to receive the output from $dump. If you press the enter 
key or enter $dump, the dump program assumes that it should direct the output to the 
terminal where you loaded $dump. Using the attention key followed by CA cancels any 
current $DUMP operation (such as control blocks or mapped storage,) but not the $dump 
program itself. 

Q If you want a display all of storage, respond to this question with an N. If any unmapped 
storage resides in the data set, the system prompts you with DUMP UNMAPPED STORAGE?. 
After you answer the prompt, the output display begins immediately and continues until 
the system dumps all of storage or you enter an attention CA. If you respond Y, $dump 
allows you to display certain sections of mapped storage. 

Q If you want a formatted display of the control blocks, respond to this question with a Y. 

Q If you want to dump mapped storage, respond with a Y and you will get the partial 
DISPLAY? prompt. If you respond N, the system does not issue the partial display? 
prompt. 

Q Enter a number 1 through 1 6 for the valid partition number that contains the storage 
you want to dump. 

"\ 

J Q Enter the starting and ending addresses of the storage you want to dump. 

Q If you want to dump another mapped storage area, respond with a Y. The system then 
prompts for the vaUd partition. 

Q If you want to dump unmapped storage, respond with a Y. The system then dumps all of 
unmapped storage. 

^ $DUMP allows you to request several dumps. If you respond with a Y, $DUMP prompts 
you again, starting with the DUMP MAPPED STORAGE (Y/N)? prompt. 



o 
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$DUMP - Format and Display Saved Environment (continued) 






Example: Partial dump output of partition 1 . 



r 



EVENT DRIVEN EXECUTIVE FORMATTED STORAGE DUMP 
AT TIME OF TRAP PSW WAS 8002 ON HARDWARE LEVEL 2 



LEVEL LEVEL 1 LEVEL 2 LEVEL 3 



lAR 

AKR 

LSR 

RO 

R1 

R2 

R3 

Kk 

R5 

R6 

R7 



0892 
0000 
OODO 
0000 
0000 
0000 
0000 
0000 
0000 
8000 
0000 



0892 

0000 

0090 

0000 
0000 
0000 
0000 
0000 
0001 
8000 
0000 



0892 

0000 

0090 

0000 
0000 
0000 
0000 
0000 
0002 

8000 

0000 



0892 

0000 

0090 

0000 
0000 
0000 
0000 
0000 

0003 

8000 
0000 



STORAGE SEGMENTATION REGISTERS: 



BLOCK ADSO 



0000 
0800 
1000 
1800 
2000 
2800 
3000 
3800 
4000 
4800 
5000 
5800 
6000 
6800 
7000 
7800 
8000 
8800 
9000 
9800 
AOOO 
A8OO 
BOOO 
B8OO 
COOO 
C800 
DOOO 
D800 
EOOO 
E800 
FOOO 
F800 



0004 

000c 

0014 
001c 
0024 
002c 
0034 
003c 
0044 
004c 
0054 
005c 
0064 
006C 
0074 
007c 
0084 
008C 
0094 
009c 
00A4 
OOAC 
00B4 
OOBC 
00C4 
OOCC 
00D4 
OODC 
00E4 
OOEC 
00F4 
OOFC 



ADS1 

0104 
010C 
0114 
011c 
0124 
012C 
0134 
013c 
0144 
014c 
0154 
015c 
0164 
016C 
0174 
017C 
0184 
018C 
0194 
019c 
01A4 
01AC 
01B4 
01BC 
01C4 
01CC 
01D4 
01DC 
01E4 
01 EC 
01F4 
01FC 



ADS2 ADS3 ADS4 ADS5 ADS6 ADS7 



0204 
020c 
0214 
021c 
0224 
022c 
0234 
023c 
0244 
024C 
0254 
025c 
0264 
026C 
0274 
027C 
0284 
028c 
0294 
029c 
02A4 
02AC 
0284 
02BC 
02C4 
02CC 
02 D 4 
02 DC 
02E4 
02EC 
02F4 
02FC 



0304 
O3OC 
0314 
03IC 
0324 
032c 
0334 
033c 
0344 
034c 
0354 
035 c 
0364 
O36C 
0374 
037c 
0384 
038C 
0394 
039c 
03A4 
03AC 
03B4 
03BC 
03C4 
03CC 
03D4 
03DC 
03E4 
03EC 
03F4 
03FC 



C""^) 

'^.y 



Mjp' 
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$DUMP - Format and Display Saved Environment (continued) 



Partial dump output of partition 1 (continued). 



STORAGE 


MAP: 


$SYSCOM AT ADDRESS I58O 




EDXFLAGS 5000 


SVCFLAGS 


8000 






PART# 


NAME 


ADDR 


PAGES 


ATASK 


TCBS{S) 


PI 


ADS=0 


0000 


256 








TESTPGM 


8000 


7 


8642(A) 


85C2 83AO 82C4 




UTILITY 


8700 


21 


9B58(A) 


9 AD 8 




$PR0GUT1 


9C00 


12 




9E22 




""FREE** 


9F00 


97 






P2 


ADS=1 


0000 


256 








**FREE** 


2800 


216 






P3 


ADS=2 


0000 


80 








**FREE** 


2800 


16 








SAMPLE01 


3800 


20 








-FREE"* 


4C00 


k 







^^s, 

\ll^ 



Chapter 4. Utilities UT-23 1 



$DUMP 

$DUMP - Format and Display Saved Environment (continued) 



Partial dump output of partition 1 (continued). 



m 



V 



DEVICE DDB INFORMATION 



^ 



TERMINAL LIST: 



NAME 

$SYSLOG 

$SYSPRTR 

$^978A 

CDRVTA 

CDRVTB 



CCB ID lODA FEAT QCB CUR-TCB CHAIN 



1A66 0^06 0004 0^00 FFFF NONE 

16A2 0306 0021 0020 0000 0000 

187C O^OE 002i» 0400 0000 4972-2 

1A56 FFFF 0000 0800 FFFF NONE 

1C3A FFFF 0000 0000 FFFF NONE 



ERROR-A 
83AO-0 



DSK(ETTE)/TAPE VDE: 
VDE NAME DDB 



077C "DDE" 

07AA ASML I B 

07D8 EDX003 

0806 *DDE* 

08EC BACKUP 

09D2 "OFFL" 



DDB lODA 

0834 0003 

09IA 0048 

OAOO 0002 

0AE6 0012 



0834 
0834 
0834 
09IA 
OAOO 
0AE6 

DEVID 
OOBA 
3106 
0106 
0106 



FLAGS 

0800 
0000 
0000 
0800 
0100 
0000 

DSCB-> 
8032-0 
0000-0 
0000-0 
0000-0 



QCB 

FFFF 
0000 

FFFF 
FFFF 
FFFF 
FFFF 



NONE " 
9822-0 

NONE 
NONE 
NONE 



CUR-TCB CHAIN (TCB-ADS) 

NONE NONE 

85C2-0 NONE 

NONE NONE 

NONE NONE 

NONE NONE 

NONE NONE 



TASK DSCB-CHAIN 
1166 3834-2* 
1166 3834-2 
11E6 NONE 
1266 NONE 



PARTITION 1 BEGINNING AT ADDRESS 0000 FOR 139 PAGES 

0000 6802 882A 0000 0000 8968 8826 8696 8826 | 

0010 0000 0000 8968 8826 OA76 0A12 8968 8826 | 

SAME AS ABOVE 

0100.. 12DC 8BC2 0004 0006 1010 6AO8 03F8 5B22 I ...B, 






$DUMP detected several errors and listed them in the format portion of the output. They 



are: 



*ERROR-A: Invalid address 

*ERROR-T: Invalid TCB 

*ERROR-L: Reasonable chain limit (150) exceeded 

*ERROR-D: Address does not exist 
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$DUMP - Format and Display Saved Environment (continued) 



If you have a program that is using unmapped storage, dump the partition where the program is 
running as well as the unmapped storage area. Determine which unmapped storage pointers 
relate to your program by locating the storblks within your program. Then use the unmapped 
storage equate ($storusr) to determine the address of the start of the Ust of unmapped storage 
pointers within this STORBLK. The unmapped storage pointers listed within the STORBLK are 
owned by your program. They point to 2K blocks of storage which should have been printed 
out. Use these pointers to locate the correct 2K blocks in your $dump Usting. Refer to the 
Problem Determination Guide for additional information. 



The following examples show dumps using stand-alone dump output. 

Example 1 : How to print a stand-alone dump for mapped and unmapped storage 



f^^. 



r 



> $L $DUMP 

DUMPDS(NAME, VOLUME): $$EDXL I B, I BMEDX 
LOADING $DUMP 22P , 12:20: 17, LP=8F00, PART=i» 

ENTER DEVICE NAME FOR OUTPUT: $SYSPRTR 

USING STAND-ALONE DUMP OUTPUT 
PARTIAL DISPLAY (Y/N)? Y 
FORMAT CONTROL BLOCKS (Y/N)? ^ 



A 



^ 



10. 11, 12, 13, 1^, 15, 16 



DUMP MAPPED STORAGE (Y/N)? Y 

VALID PARTITIONS ARE: 

1, 2, 3, 4, 5, 6, 7, 8, 

ENTER PARTITION # : 1 

ENTER START ENDING ADDRESS IN HEX (2 WORDS): 0000 OBOO 

ANOTHER MAPPED AREA (Y/N)?^' 

DUMP UNMAPPED STORAGE (Y/N)? Y 

$DUMP REQUIRES DISKETTE #2, PLEASE MOUNT DISKETTE 
PRESS "ENTER" TO CONTINUE OR "PF3" TO END DUMP 
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$DUMP - Format and Display Saved Environment (continued) 



Example 2: How to copy a stand-alone dump from diskette(s) to disk. 



r 



> $L $DUMP $$EDXLIB,IBMEDX 
LOADING DUMP 77P ,02:54:07 , LP= O8OO, PART= 3 
ENTER DEVICE NAME FOR OUTPUT: $SYSPRTR 
PARTIAL DISPLAY (Y/N)? Y 
USING STAND ALONE DUMP OUTPUT 

MAPPED STORAGE SPANS DISKETTE WHICH WILL CAUSE REPEATED 
DISKETTE SWITCHING DURING CONTROL BLOCK FORMATTING 

IF DUMP DATA SET IS COPIED TO DISK DATA SET, NO DISKETTE SWITCHING 
DISK DATA SET MUST BE 8200 RECORDS IN LENGTH 

COPY DISKETTE(S) TO DATA SET (Y/N)? Y 
TARGET (NAME, VOLUME): DUMPDS ,EDX003 

$DUMP REQUIRES DISKETTE # 2, PLEASE MOUNT DISKETTE 
PRESS "ENTER" TO CONTINUE OR "PF3" TO END DUMP 

$DUMP REQUIRES DISKETTE # 3, PLEASE MOUNT DISKETTE 
PRESS "ENTER" TO CONTINUE OR "PF3" TO END DUMP 

$DUMP REQUIRES DISKETTE # 4, PLEASE MOUNT DISKETTE 
PRESS "ENTER" TO CONTINUE OR "PF3" TO END DUMP 

DUMP DATA SET COPIED TO DUMPS, EDXOO3 

CONTINUE DUMP FROM DISK DATA SET (Y/N)? Y 
FORMAT CONTROL BLOCKS (Y/N)? Y 



9, 10, 11, 12, 13, 14, 15, 16 



VALID PARTITIONS ARE: 

1, 2, 3, 4, 5, 6, 7, 
ENTER PARTITION # : 4 

ENTER START AND ENDING ADDRESS IN HEX (2 VALUES): 200 600 
ANOTHER MAPPED AREA (Y/N)? N 

DUMP UNMAPPED STORAGE (Y/N)? N 
ANOTHER AREA (Y/N)? N 









$DUMP 



ENDED AT 03:46:33 



~\ 
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$EDIT1 and EDIT1N - Line Editors 



$EDIT1 and $EDIT1N provide a text editing facility (primarily used for source program entry and 
editing) that you can load while other programs are executing. The Host Communication 
Facility-related version ($editi) provides a few commands for data communication using the 
Host Communications Facility lUP on the System/370; with them you can control almost the 
entire process of program preparation from a Series/ 1 terminal. 

Both utilities work with 80-character lines with line numbers in positions 73-80. You invoke 
them with the $L operator command. 



Data Set Requirements 






The editing facility requires one work data set; you must allocate it on disk or diskette using 
$DISKUT1. The system prompts you for its name when you invoke either version. This data set 
contains both your data and some index information during the editing session. The size 
(number of records) of the data set determines the maximum number of data records that it can 
contain. It is divided into three parts: 

1. One header record 

2. A series of index records (32 entries per record) 

3. A series of data records (3 entries per record). 

You can calculate the required data set size as follows: number of text lines (n) divided by 30, 
times 11, plus 1 ((n/30 x 11) + 1). 

Note: The data set must contain fewer than 32768 records. 



Invoking $EDIT1 or$EDIT1N 



You invoke $EDIT1 or $editin with the $L operator command. The session manager does not 
support either utility. 



Chapter 4. Utilities UT-235 



$EDIT1 and$EDIT1N 



$EDIT1 and EDIT1 N - Line Editors (continued) ^^ 

Sequence of Operations 

When you invoke $EDIT1 and $EDIT1N, they prompt you for the name of the work data set. If 
you are going to edit an existing data set, use the read command to copy the data set to the 
work data set. For a new data set, enter edit mode. You can print the contents of the work data 
set by using the LIST command. 

Use the edit command to enter edit mode. The system then recognizes "Edit Mode 
Subcommands" on page UT-247 until you end the utility with the END command. 

Note: You should use the VERIFY ON subcommand until you become familiar with the editing 
process. 

Use the tabset subcommand if you want to specify the tab character and tab column. TABSET 
eliminates blanks when a substantial amount of the text you are entering is in tabular format or 
begins in a particular column. 

You can enter data a line at a time under the INPUT subcommand (recommended for new data 
sets and bulk sequential updates because of the automatic prompting feature) or by using the 
Une editing function (for single-line corrections). You can list portions of the edited data at the 
terminal by using the LIST command. 

The FIND, TOP, BOTTOM, UP, and DOWN subcommands control the position of the current Une 
pointer. 

You can end edit mode with the END command. After you have edited the text, use either the 
WRITE or SAVE subcommand to copy the work data set to a permanent data set. The work data 
set is in a blocked format that is incompatible with most Event Driven Executive functions. 
Therefore, the system performs automatic translation from text editor format to source 
statement format. 

The following figure shows the primary commands and subcommands available under 

$EDIT1/$EDIT1N. 



^ 
W 
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$EDIT1 and EDIT1N - Line Editors (continued) 



^f^*\ 































>$L$EDIT1/N 






' 


















Editor ready J 




COMMANDS 










' 


' 




' 






1 






LIST (printer) 
READ 
WRITE 
SUBMIT 




END$EDIT1/N 




EDIT 










1 ' 




/ 


Edit mode . 






\ 




SUBCOMMANDS 








^ 




1 


' 




1 


' 




' ' 




1 






INPUT 




END 




LIST (terminal) 

VERIFY 

RENUM 

SAVE 

TABSET 




LINE EDIT 


























CHANGE 
COPY 
DELETE 
MOVE 




FIND 

TOP 

BOTTOM 

UP 

DOWN 























Figure 14. $EDIT1/$EDIT1N commands and subcommands 
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$EDIT1 and EDIT1N - Line Editors (continued) 



Special Control Keys 

1. End-of-Line Character (see note below). You can use the carriage return key (CR)/enter 
to end an input line. 

2. Line-Delete Character (see note below). You can use the delete key (del) of certain 
teletypewriter terminals to delete an input Une. 

Note: You can define the CR and del keys in the TERMINAL statement. See the Installation 
and System Generation Guide. 

3. Character-Delete Character. You can use the backspace (bs) key on terminals for the 
character delete function. On teletypewriter terminals, use the CTRL and H keys 
simultaneously. 

4. Tabulation Character. You can set the TAB character to the character of your choice. '%' is 
the default tab character. Columns 10, 20, 40, and 72 are the default tab columns. 



5. ATTN Key (4978/4979), ALT MODE and pf8 Key (3101), or ESC or alt mode Key 
(teletypewriter terminals). You can cancel the subcommands CHANGE, FIND, and LIST, 
described below, by pressing the ATTN/ESC key and entering, as a special system utility 
function, the two-character code CA. This feature is useful, for example, to end a long 
listing. 



Editor Commands 



H^..._^'' 



The editor commands are described in the following pages. Unless specifically indicated, the 
commands apply to both the host and native versions of this utility. The editor commands are: 



COMMAND 



DESCRIPTION 



EDIT 

END 

LIST 

READ 

SUBMIT 

WRITE 



Enters edit mode; allows edit subcommands 
Ends$ED!T1 and$EDIT1N 
Lists the work data set on the system printer 
Reads a source data set into the work data set 
Submits a job to the host batch job stream 
Writes the work data set into a source data set 



The descriptions that follow show the syntax of the editor commands, including any operands 
associated with them. 
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$EDIT1 and EDIT1N - Line Editors (continued) 

EDIT — Enter Edit Mode 

Use EDIT to begin editing source data. 

Syntax: 



f^. 

^h,,^ 



EDIT OLD/NEW 

Required: none 

Defaults: NEW when using a newly allocated work data set 

OLD when using an old work data set 
Alias: E,ED 



Operands Description 

OLD Indicates that data exists in the data set you want to modify. 

NEW Indicates that you are creating new data. 

Notes; 

1 . You must enter the edit command before you can use the editor subcommands. 

2. When you are in edit mode, you must enter the subcommand end or SAVE before you can 
use the editor commands hsted on the preceding page. 
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$EDIT1 and EDIT1 N - Line Editors (continued) 

END — End $EDIT1/$EDIT1N 

Use END to end execution of $EDIT1 or $editin. 

The system will not change the contents of the edit work data set. You can reinvoke 
$EDIT1/$EDIT1N at a later time and continue. 



Syntax: 



END 

Required: none 
Defaults: none 
Alias: EN 



Operands Description 
None 



/' 
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$EDIT1 and EDIT1N - Line Editors (continued) 



LIST — List Work Data Set 



Use LIST to print all or part of the work data set on the system printer ($SYSPRTR). You can 
enter a single line number or a pair of Une numbers to specify a line range. If you do not enter 
any line numbers, the system lists the entire data set. You can end the listing by pressing the 
attention key and entering CA. Note a similarity to the edit subcommand. If you use list as a 
command following ready, the the system prints the data set on $sysprtr. If you use list as a 
subcommand following edit, the system displays the data set on your terminal. 



Syntax: 



LIST line-spec 

Required: none 
Defaults: none 
Alias: L,U 






Operands Description 

line-spec '*' (for the current line) or 'line-number' to indicate a single line to be hsted. '* 

COUNT' or 'linenuml hnenum2' to display a range of lines. If you omit this 
operand, the system prints the entire data set. 



Example: 
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$EDIT1 and EDIT1 N - Line Editors (continued) 

READ — Retrieve Host Data Set ($EDIT1) 

Use READ to retrieve a data set from the host system and store it in your Series/ 1 work data set. 

You must have the Host Communications Facility on the System/370. 



J 



Syntax: 



READ dsname 

Required: none 

Defaults: If you omit dsname, the system prompts you 

Alias: none 



Operands Description 

dsname The fully qualified name of the host data set to be retrieved. It must contain fixed 

length, 80-byte records, with line numbers in columns 73-80. 

You can enter the command and name together on the same line or enter the 
command read and the system prompts you for the data set name. 
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$EDIT1 and EDIT1N - Line Editors (continued) 

READ — Retrieve Series/1 Data Set ($EDIT1N) 

Use READ to retrieve a named data set from a volume on the Series/ 1 disk or diskette and store 
it in a Series/ 1 work data set. 

Syntax: 



READ 


dsname 


volname 




Requirec 


: none - 


system prompts for 


operands 


Default: 


none 






Alias: 


R, RE 







Operands Description 

dsname Name of data set you want to retrieve 

volname Name of the volume containing the data set you want to retrieve 

Note: You may enter these operands as responses to system prompts. 
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$EDIT1 and EDIT1 N - Line Editors (continued) f^ 

K.3 



SUBMIT — Submit Job to Host ($EDIT1) 



Use SUBMIT to inject a job (job control statements and optional data) into the host batch job 
stream. 

You must have the Host Communications Facility on the System/370. 

Note: Use this option only in systems with a HASP or JES/Host Communication Facility 
interface. 



Syntax: 




Operands Description 

dsname The fully qualified name of the host data set, the contents of which you want 

entered into the job stream. This data set must contain fixed length, 80-byte 
records. 

DIRECT If you specify it, the system transfers the contents of your edit work data set i ) 

directly to the host job stream. ^ J"**^ 



^kmu""*^ 
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$EDIT1 and EDIT1N - Line Editors (continued) 



WRITE — Write Work Data Set to Host {$EDIT1) 

Use WRITE to transfer your Series/ 1 work data set to a host data set. The system assumes that 
you have edited or created your data set with the $editi utility program. 

You must have the Host Communications Facility on the System/370. 

If you previously specified a host data set, the utility asks if you wish to reuse it. If you do not, 
or if you did not specify one previously, the utility prompts you for a new host data set name. 



Syntax: 



WRITE dsname 



Operands Description 

dsname The fully qualified name of the target host data set. This data set should contain 

fixed-length, 80-byte records. 



1^ 



You can enter the command and name together on the same line or enter only the 
command WRITE. The system prompts you for the data set name. 



EDITI issues the following prompt: 



L 



NAME; 
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$EDIT1 and EDIT1N - Line Editors (continued) 



WRITE — Write Work Data Set to Series/1 Data Set ($EDIT1N) 

Use WRITE to copy the Series/ 1 work data set to a named data set in a Series/ 1 disk or diskette 
volume. 



o 



Syntax: 



WRITE 

Required: none - System prompts you for operands 
Default: copy to the originating data set, if any 
Alias: W, WR 



Operands Description 
None 

EDIT IN issues the following prompt: 

I WRITE TO READVS ON READVOL (Y/N)? 

where READVOL is the originating volume and READVS is the originating data set. The system 
issues this prompt only if you initiaUzed the work data set via the READ command. If you 
respond NO or if the data set is new, the system issues the following prompt: 



P 



V 



ENTER (NAME, VOLUME): 



xJ 
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$EDIT1 and EDIT1 N - Line Editors (continued) 

Edit Mode Subcommands 

The subcommands used to edit your work data set while in edit mode are described as follows: 






Subcommand 


Operands 


BOTTOM 




CHANGE 


line-spec /textl /text2/ALL 


COPY 


line-spec 


DELETE 


line-spec 


DOWN 


count 


END 




FIND 


/character-string/ 


INPUT 


line-number increment 


Line Editing 


line-number character-string 


LIST 


line-spec 


MOVE 


line-spec 


RENUM 


new-line-number increment 


SAVE 




TABSET 


ON(integer list), OFF, CH(character) 


TOP 




UP 


count 


VERIFY 


ON/OFF 



The descriptions that follow show the syntax of the subcommands including any operands 
associated with them. 



BOTTOM — Set Line Pointer to Bottom 



Use BOTTOM to reposition the current hne pointer (*) to the last Une of the data set you are 
editing. 



Syntax: 



BOTTOM 

Required: none 
Defaults: none 
Alias: B,BO 



Operands Description 
None 
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$EDIT1 and EDIT1N - Line Editors (continued) 

CHANGE — Change Character String 

Use CHANGE to modify a character string in a line or range of lines. 



Syntax: 



CHANGE line-spec /textl /text2/ALL 

Required: /textl /text2 
Defaults: line-spec defaults to *. 
Alias: C,CH 



Operands 
line-spec 



/textl /text2/ALL 



Example: 



Description 

* or blank for the current line. 

'* count' or 'linenuml linenum2' for a range of lines. 

'line-number' for a particular line. 

'/' can be any nonnumeric character except blank, tab, and asterisk. It is 
not a part of and cannot appear within the character strings 'textl' and 
'text2'. The system searches the line or range of lines for 'textl', which it 
replaces with 'text2' if it finds it. Note that you must use the same 
character for both delimiters in any one change command. 

The keyword 'ALL' is optional and causes the system to replace every 
occurrence of 'textl' in the line(s). 

Two adjoining delimiters denote a null operand. If textl is a null 
operand, then the system inserts text2 at the start of the line and shifts 
the line to the right. If text2 is a null operand and you specify textl, the 
system removes text2 from the line and shifts the rest of the line to the 
left. 



1. 



C 20 /ABC/ADC/ 

C 100 250 =/*=//=ALL 

C * //XYZ 

C /PROG/PGM/ 
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$EDIT1 and EDIT1N - Line Editors (continued) 



COPY — Copy Text 



^^_ 



Use COPY to duplicate text from one location in a data set to another location within that data 
set. The 'from' and 'to' text both remain in the data set. 



Syntax: 



COPY linenuml Iinenum2 Iinenum3 

Required: linenuml linenumS 
Defaults: linenuml linenumS defaults to 

a single line copy of '1' to '3'. 
Alias: CO 



Operands Description 

linenuml The first line of text you want to copy. 

linenuml The last line of text you want to copy. 

Iinenum3 The line of text after which you want to place the copied text. 

All specified line numbers must exist. 'Iinenum2' must be equal to or greater than 'linenuml'. 

'Iinenum3' must be less than 'linenuml' or equal to or greater than 'linenuml' when you specify 
three line numbers. 

The system renumbers the data set with standard specifications. It Usts the original 'Unenum2' 
with its new line number on exit. 

Examp/es: 



CO 


100 


300 


60 


CO 


120 


250 


820 


CO 


150 


150 


310 


COPY 


150 


310 



Note: The last two examples are equivalent. 
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$EDIT1 and EDIT1IM - Line Editors (continued) 



(4 i/ 



DELETE — Delete Text 



Use DELETE to remove records from the data set. The system repositions the current line 
pointer (*) prior to the deleted lines. 



Syntax: 



DELETE line-spec 

Required: none 
Defaults: * 
Alias: DE 



Operands Description 

line-spec * for current line. 

'* count' or 'Unenuml linenum2' for a range of hues. 

'line-number' for a particular line. 
Examples: 



\^ y 



DELETE * 
DE * 4 
DE 100 150 
DE 125 
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$EDIT1 and EDIT1N - Line Editors (continued) 

DOWN — Move Line Pointer Down 

Use DOWN to move the current line pointer (*) toward the end of the data set. 






Syntax: 



DOWN count 

Required: none 

Defaults: 'COUNT defaults to 1 

Alias: DO 



Operands Description 

count Specifies the number of Unes you want to move the current Une pointer. 

Examp/es: 



DOWN 5 
DO 10 
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$EDIT1 and EDIT1N - Line Editors (continued) 



END — Exit Edit Mode 



Use END to request that the system end the edit mode. You can use the editor commands now 
relative to your finished source data. To save or Ust your data set or to write or submit your 
data set to the host, see "Editor Commands" on page UT-238. The contents of the work data 
set remain unchanged. You can reenter the edit mode using the edit command and continue 
editing the work data set. 



Syntax: 



END 

Required: none 
Defaults: none 
Alias: EN 



Operands Description 



None 
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$EDIT1 and EDIT1N - Line Editors (continued) 



FIND — Find Character String 



Use FIND to search for a specific character string beginning with the current Une, if you specified 
operands. The system moves the current line pointer (*) to the first line it finds that contains 
the string. It searches every position within each Une. 

Note: You should set VERIFY to ON when you use the find command. 

Syntax: 



FIND =char-string= 

Required: none 

Defaults: If no operands are specified, those specified 
on the last previous issue of the FIND 
subconnmand are assumed. The search begins at 
the line following the current line. 

Alias: F,FI 



Operands Description 

=char-string= You can choose any nonnumeric character which does not appear within the 
specified character string (except blank, tab, or asterisk) to be the string 
delimiter. You can replace the second occurrence with a carriage return. 
Note that both deUmiters must be the same character. 



Examples: 



FIND /START/ 

F 

FI =DATA X'OOFl '= 
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$EDIT1 and EDIT1N - Line Editors (continued) 



INPUT — Input Text 



Use INPUT to add or replace lines. You can use INPUT any time in edit mode by pressing the 
enter key. The system then adds lines to the end of the data set. 

To end INPUT mode, press the enter key immediately after you receive the prompt for the next 
line number. 



Syntax: 



INPUT line-number increment 
or 
* increment 

Required: none 

Defaults: increment defaults to previous one or to 10 

Alias: UN 



Operands Description 

line-number The first line the system inserts will have this number or this number plus the 

increment if the specified Une number already exists. 






increment The increment for numbering inserted hnes; the default is the increment you 

specified previously or 10 if you don't specify another. 

* The system inserts lines at the current line position plus the default increment; 

if you specified no operands, the system inserts Unes at the end of the data set 
plus the default increment. 



Examples: 



INPUT * 1 
IN 100 5 
I 20 
I 
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$EDIT1 and EDIT1N - Line Editors (continued) 

LIST — List Work Data Set 

Use LIST to display, at the terminal, lines of the data set you are editing. 



Syntax: 



LIST line-spec 

Required: none 

Defaults: line-spec defaults to entire data set 

Alias: L,LI 









Operands Description 

line-spec (*) or line-number to indicate a single line you want to list; '* count' or 'linenuml 
linenum2' to display a range of lines. 

Examples: 



LIST 10 100 
L * 5 
L * 

LI 
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$EDIT1 and EDIT1 N - Line Editors (continued) 






MOVE — Move Text 



Use MOVE to move text from one location in a data set to another location within that data set. 
The system deletes the 'from' text and leaves only the 'to' text in the data set. 



Syntax: 



MOVE 


linenuml 1 


inenum2 linenumS 






Required 


: linenuml 


linenumS 






Defaults: 


linenuml 


linenumS defaults to 


move one 


line. 


Alias: 


MO 









Operands Description 

linenuml The first line of text you want to move. 

linenuml The last line of text you want to move. 

Iinenum3 The line of text after which you want to place the moved text. 

All specified line numbers must exist. 

'Iinenum2' must be equal to or greater than 'Hnenuml'. 

'linenumS' must be less than 'Hnenuml' when you specify two line members or greater than 
'Unenum2' when you specify three line members. 

The system renumbers the data set with standard specifications and lists the original 'linenum2' 
with its new line number on exit. 

Examp/es: 



\^. 



j/ 



MO 100 300 60 
MO 120 250 820 
MO 87 87 310 
MOVE 87 310 



Note: The last two examples are equivalent. 



\J^ 
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$EDIT1 and EDItIN - Line Editors (continued) 



RENUM — Renumber Work Data Set 

Use RENUM to renumber each line of a line-numbered data set or to assign line numbers to each 
Une of an unnumbered data set. 






Syntax: 



RENUM new-line-number incrennent 

Required: none 

Defaults: Both new-line-nunnber and increment 

default to 10 
Alias: R, RE 



Note: 'new-line-number' is required if 'increment' is specified. 

Operands Description 

new-line-number The sequence number you want to assign to the first line processed. 

increment The increment you want to use in renumbering. 

Examples: 



RENUM 10 10 
RE 100 5 
RENUM 
R 
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$EDIT1 and EDITIN - Line Editors (continued) 



SAVE — Save Work Data Set 



Use SAVE to write the current contents of the work data set to a host data set with the 
host-related version ($editi) or to a Series/1 data set with the native-related version ($editin). 

If you specified a data set previously (e.g., in a read command), the system asks you if you wish 
to write onto that data set; otherwise, it prompts you for a new data set name. 



Syntax: 



SAVE dsname 

Required: none 
Defaults: none 
Alias: S, SA 



Operands Description 



dsname When you use $EDIT1, the system prompts you for the target host data set name; it 

must be a fully qualified data set name. 

When you use $EDIT1N, you must have allocated the target data set previously in a 
volume on a Series/ 1 disk or diskette. The data set should contain fixed-length, 
80-byte records. The system prompts you for the target-volume name. 






Examples: 




\J 
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$EDIT1 and EDIT1N - Line Editors (continued) 



TABSET — Set Tabs 



Use TABSET to reestablish tab values or nullify existing tab values. The system maintains the 
tabulation character and tab stop values as part of your work data set. (You can change them 
later.) 

You can enter the tab character anywhere in the data Une under the INPUT subcommand or Une 
editing function. It causes a skip to the next tab position if you enter the data Une into the work 
data set. The resulting line is not visible, but you can display it if you want. 



Syntax: 






TABSET 
TABSET 
TABSET 


ON(integer-list) 

OFF 

CH(tab-character) 


Required: ON, OFF, 
Defaults: none 
Alias: TA 


orCH 



Operands Description 

integer-list The relative column positions in each line to which you want the tab values 

set; initial system defaults are 10, 20, 40, and 72. 

tab-character A new tab character; the standard is a percent sign, %. 

OFF Resets relative tab column positions to initial systems defaults. It does not 

reset tab characters. 
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$EDIT1 and EDIT1N - Line Editors (continued) 



Example 1 : These lines show the various ways of entering tabset subcommands and 
parameters. 



1. The system sets the relative tab column positions to initial system defaults of 10, 20, 40, and 

72. 



TABSET ON (10 20 40 72) 



2. The system sets the relative tab column positions to 10, 16, and 31. 



TA ON ( 1 16 31) 



3. The system designates the tab character as the pound sign, #. 



TA CH(#) 



4. The system resets the relative tab column values to the initial system defaults. 



TA OFF 






Example 2: The Unes below show how you can set tab positions on different lines and then 
verify them in the EDIT mode. 

1. The system sets the tab column positions to 10 and 20. 




2. The system sets tab position 1 on line 36 of the work data set. The tab character is the 
default, the percentage sign, %. 



36 %TAB POSITION 1 



3. Use the INPUT subcommand to add two lines to the work data set: lines 37 and 38. 
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$EDIT1 and EDIT1N - Line Editors (continued) 



INPUT 37 1 



4. The INPUT subcommand prompt asks for further entries in the input mode. If you don't 
want any more entries, exit the input mode pressing the enter key. 



INPUT 



5. The system displays line 37 and sets tab position 2 using the tab character, %. 



00037 %?STAB POSITION 2 






6. The system displays the new line 38. 



00038 



7. Enter the edit command to get back into the edit mode. 



EDIT 



8. Use the LIST subcommand to request the display of lines 36 and 37 of the work data set. 



LIST 36 37 



9. The system displays data set hnes 36 and 37, showing where it placed tab positions 1 and 2 
within the Unes. 



00036 
00037 



TAB POSITION 1 

TAB POSITION 2 
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$EDIT1 and EDIT1 l\l - Line Editors (continued) 

TOP — Set Line Pointer to Top 

Use TOP to position the current line pointer (*) before the first Une of the data set. 






Syntax: 



TOP 

Required: none 
Defaults: none 
Alias: TO 



Operands Description 

None 

Note: If VERIFY is ON, the system prints no Hne because the current Une number 
precedes the first line. 

UP — IVIove Line Pointer Up 

Use UP to move the current line pointer (*) toward the start of the data set. 



,^" 



\::.J^ 



Syntax: 



UP count 

Required: none 

Defaults: count defaults to 1 

Alias: U 



Operands Description 

count The number of Unes that you want the current line pointer (*) moved. 

Examp/e: 



UP 10 



KJ 
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$EDIT1 and EDIT1N - Line Editors (continued) 



VERIFY — Display Changes on Terminal 

Use VERIFY to display the changes you made on the terminal (on) ; verification is OFF until you 
invoke it the first time during an edit. 



Syntax: 



VERIFY ON/OFF 

Required: none 
Defaults: ON 
Alias: V,VE 



Operands Description 



»i«Hi|. 



ON Each time the position of the current line pointer (*) changes, the system prints the 

Une to which it moves. In addition, the system verifies modifications you made in 
fields of records using the 'character-string' or 'text' forms of the CHANGE 
subcommand. 

OFF The system will not verify changes you make to the position of the current hne 

pointer (*) and to fields of records by means of the change subcommand. 



Examples: 



V ON 
V 

V OFF 
VERIFY 
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$EDIT1 and EDIT1N - Line Editors (continued) 

Line Editing Commands 

The line editing commands allow you to add, replace, or delete a single line from the data set 
you are editing. 

Note: Line editing functions are not subcommands. 

Syntax: 



line-number character-string 

Required: line-number 
Defaults: none 



o 



Note: If you specify 'character-string', you must separate it from 'line-number' by a 
single blank or tab. 

Operands Description 

line-number 'line-number' with no character string deletes the line having the 

specified number (it does nothing if the line does not exist). 

'line-number', followed by a character string, adds the string to the data 
set. If a line having the specified number already exists, the system 
replaces it. 

character-string The text of the line you want to add. 

Line Editing Examples: Add a line (line #12345 does not exist). 






k 



123^5 This line is being added 

Delete line 12345. 
I12345 

Replace line 12345. 
Il2345 This line replaces 12345 



A 
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$EDXASM - Event Driven Language Compiler 

The Event Driven Language compiler, $EDXASM, translates source programs coded in the Event 
Driven Language into object modules. Multiple copies of $edxasm can operate concurrently if 
each copy has its own separate data sets. 

Before using $edxasm, you must enter the source program you want compiled onto a disk, 
diskette, or tape data set by means of one of the text editor utilities ($editin or $FSEDIT). 

Required Data Sets 

The $EDXASM compiler requires four data sets. You must specify the first three data sets in the 
order shown when you use the $L operator command to invoke $EDXASM. You must specify 
data sets one and three when you invoke $edxasm using the session manager. You do not need 
to specify the name of the fourth data set. The system uses the default name $EDXL unless you 
change it at run time using the CONTROL (CO) option. 

1. The source program input data set (DSl) contains the program you want to compile. Use a 
text editor ($editin or $fsedit) to create the source data set. You must specify the name 
of this data set when you invoke $EDXASM. 

2. The compiler uses the work data set (DS2). It contains object code, relocation pointers, and 
the symbol table. You must allocate this data set if you use the $L operator command to 
invoke $edxasm. Allocate 100 records for a small program, 250 records for an 
average-sized program, and 500 records for a large program. Specify the name of the data 
set you allocated as a parameter on the $L operator command. The session manager 
automatically allocates this data set with a size of 400 records. 

3. The object data set (DS3) will contain the output object module. It is input to $edxlink. 
The size is dependent on the program size. For estimation purposes, divide the program 
length in bytes by 100 to get the number of records required. In most cases, 25 to 50 
records should be sufficient. You must allocate this data set and specify its name when you 
invoke $EDXASM. The eod pointer is set to the end of the data after the system writes the 
output object module. 

4. The language control data set (DS4) contains control information that $edxasm uses. This 
data, named $edxl, is divided into two logical parts: the error messages and the operation 
codes to process module specifications. The format of this data set enables you to modify 
the data set by using either text editing utility ($EDIT1N or $fsedit). 

$EDXL in volume ASMLIB contains the standard compiler error messages and Event Driven 
Language instruction set specifications. You may wish to add COPY code definitions or 
additional processing modules and error messages and may even desire to have differently 
modified versions assigned to different users. Use the *copycod function to add additional 
modules to $edxl. The contents of $edxl are described in the Internal Design. 

To conserve space and speed, $edxasm does not always flag operands as errors when the 
operand does not belong to the instruction. If not flagged, the erroneous operand does not 
expand or affect the instruction. 
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$EDXASM - Event Driven Language Compiler (continued) 



Invoking $EDXASIVI 



You invoke SEDXASM with the $L operator command, by option 2. 1 of the session manager, or 
by the $jobutil utility. In each case, you must provide the same information when you load 
$EDXASM for execution. 



You can cancel the compilation or the subsequent listing at any time by pressing the attention 
key and entering CA. 



Compiler Options 



Basic Options 



You can specify the option(s) you want when you invoke $edxasm. The options you select 
direct the processing that the compiler will do. 

Each option name is followed by its two-character abbreviation. 



The following basic compiler options are available: 

CANCEL (CA) Causes the immediate termination of $EDXASM. 

END (EN) Ends option selection. 

ERRORS (ER) Specifies that the system should print only statements with errors. The system 
requires a device name. Similarly, a null entry or asterisk (*) indicates that 
you want the system to list the error messages on the loading terminal. Use 
this option for the first few compilations to remove typographical or simple 
syntactical errors from the source program. 

LIST (LI) Indicates that you want the system to print a full program listing (this is the 

default). Specify list only if you want the hsting to go to a printer other than 
$SYSPRTR (the default). 

NOLIST (NO) Indicates that you don't want a listing. The system prints the compiler 
statistics on the terminal where you loaded $edxasm. 
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$EDXASM - Event Driven Language Compiler (continued) 

Special Options 

The following special options are available: 

BUILD (BU) Causes the system to construct and write $EDXASM disk location information 

and instruction set table to the language-control data set. Use BUILD only 
when the language-control data set has changed or when the disk location of 
one or more parts of $EDXASM has changed. If a load fails because of 
outdated disk directory information, the system prints an error message and 
ends the assembly. 

CONTROL (CO) Specifies the language-control data set you want to use. If the system 

requires a language-control data set other than $edxl on the volume from 
which $EDXASM was loaded, enter CONTROL followed by the name and 
volume of the data set you want to use. 

OVERLAY (OV) Specifies the number of storage areas into which $EDXASM is loaded. The 
default is six, with a minimum of one and maximum of six. A large number 
of storage areas reduces the number of storage loads the system requires, 
thus improving performance. If sufficient storage is not available for the 
requested number of storage areas, $EDXASM allocates the number of storage 
areas that do fit into the available space. You can find further information 
on multiple overlay area management in the $edxasm section in the Internal 
Design. 

RESET (RE) Causes the system to clear the area in the language-control data set where 

BUILD stored overlay and instruction information. If this overlay and 
instruction information is present in the language-control data set, $EDXASM 
uses it instead of reconstructing the information for each execution, with a 
substantial savings in execution time. 

Data Sets Used in Examples 

The following data sets are used in the examples: 

ASMSRC The source input data set. 

ASMWORK The work data set (the session manager supplies a different work data set). 

ASMOBJ The object output data set. 

If you do not specify the volume name for these data sets, the system uses the ipl volume as the 
default volume. 
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$EDXASM - Event Driven Language Compiler (continued} 

Compiling a Program Using the $L Command 

The following examples show how to invoke $edxasm using the $L operator command. Both 
prompt/reply mode and single-line entry of commands are shown. For these examples, 
SEDXASM is stored on asmlib. 

For examples of compihng a program using the session manager or the job stream processor 
utiUty ($J0BUTIL), see the Event Driven Executive Language Programming Guide. 

Specifying Data Sets After Invoking $EDXASM 

After you have entered the $L operator command, $EDXASM prompts you for the names of the 
required data sets. 



> $L $EDXASM, ASMLIB 
SOURCE (NAME, VOLUME) 
WORKFILE(NAME, VOLUME) 
OBJECT (NAME, VOLUME) 



ASMSRC 

ASMWORK 

ASMOBJ 



LOADING $EDXASM 
\ 



64P, 02:^+8:50, LP= 6300, PART=1 



The following single-line entry is equivalent to the multiline entries above: 
1 > $L SEDXASM, ASMLIB ASMSRC ASMWORK ASMOBJ 



After you enter the names of the required data sets, SEDXASM prompts you for a compiler 
option. 



J 







IsE 



SELECT OPTIONS (?): 



\j. 
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$EDXASM - Event Driven Language Compiler (continued) 



o 



Selecting Compiler Options 



To display a list of the compiler options, enter a question mark in response to the SELECT 
OPTIONS prompting message as follows: 



r 



\, 



SELECT OPTIONS (?j: ? 

LIST - SPECIFY LIST DEVICE 

NOLI ST - DO NOT PRINT LISTING 

ERRORS - LIST ERRORS ONLY 

CONTROL - SPECIFY CONTROL LANGUAGE 

BUILD - BUILD OPCODE TABLE 

RESET - RESET OPCODE TABLE 

OVERLAY - SPECIFY NO. OF OVERLAY AREAS 

CA - CANCEL ASSEMBLY 

END - END OPTION SELECTION 

('ATTN - CA' TO CANCEL ASSEMBLY DURING EXECUTION) 

SELECT OPTIONS (?): 



Press the enter key to let the compiler options default. 

You can enter all option entries on a single line or in response to prompt messages. The last 
listing option you enter takes precedence. 






The following examples show the use of various option selections. 

Print Full Compiler Listing on $SYSPRTR (Default): If you don't select select any 
options (indicated by entering only a carriage return or enter in response to the select option 
message), the default is LIST on $SYSPRTR using the language control data set $edxl on the 
$EDXASM program volume (asmlib). 



I 



SELECT OPTIONS (?): (null entry) 



Print Compiler Errors Only on Printer Named PRINTER1 : If you want a compiler 
listing on another device, specify list or L. Enter the name of the device in response to the 
prompt for device name or enter it all on the same line. Use a null entry or an * to specify the 
terminal you are using. 
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$EDXASM - Event Driven Language Compiler (continued) 



Both of the following examples print errors only on printer i. 



V^ 



SELECT OPTIONS {?): ERRORS 
DEVICE NAME: PRINTERl 

SELECT OPTIONS (?): END 



or 



I 



SELECT OPTIONS (?): ER PRINTERl END 



Print No Listing and Use Control Data Set $EDXL on EDX002: Specify the name of 
the control-language data set you want to use by selecting the control option. Use this option 
when the control data set is different than the default. 

The following example prints no compiler listing and uses the control data set $EDXL on volume 

EDX002. 



v^ 



SELECT OPTIONS {?): NO CONTROL 
CONTROL (DSNAME, VOLUME): SEDXL,EDX002 
SELECT OPTIONS (?): END 



Output of the Compiler 

This section describes the output of the $edxasm compiler: 

• Statistics 

• Object module 

• Program Usting 

• Completion codes 
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$EDXASM - Event Driven Language Compiler (continued) 



Statistics 



Object Module 



When the system completes the compilation process, the compiler prints statistics indicating: 
Source, work, and object data sets used 
Date and time the compilation started 
Elapsed time for the compilation 
Number of statements processed 
Number of statements flagged with error messages. 



The system stores the object module at the end of the compilation. Then it is ready for input to 

$EDXLINK. 

Since the system stores the output object module before it starts any Hsting, $edxlink can 
process the object module while the system is producing the listing. The operation of $EDXLINK 
is described in "$EDXLINK - Linkage Editor" on page UT-274. 

Note; During assembly, there is a possibility that the system may have given the same value to 
different labels, causing assembly errors. If this occurs, modify one of the labels and reassemble 
the source. 



If you request a program Hsting, the system prints it on the appropriate output device. The 
listing routine of $EDXASM automatically suppresses the printing of duplicate hnes of object 
code. Before the system uses the data sets specified in the compilation, you can request a hsting 
of the compilation using the program $EDXLIST. Refer to "Obtaining Extra Compilation 
Listings" for more information. 

Completion Codes 

The system prints completion codes on the invoking terminal and on a printer device. Refer to 
Messages and Codes for SEDXASM completion codes. 

Obtaining Extra Compilation Listings 

Use $EDXLIST to obtain a listing of the last $edxasm compilation that the system performed. 



Program Listing 
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$EDXASM - Event Driven Language Compiler (continued) 

Invoking $EDXLIST Automatically 

You can specify list or nolist in response to the select options (?): prompt when you load 
$EDXASM. A response of the enter key, LIST, or ERRORS, causes $EDXASM to load $edxlist and 
produce a listing of the compilation. If you respond with nolist, the system displays statistics 
from the compilation on the loading terminal and produces no listing. 

Invoking $EDXLIST Manually with the $L Operator Command 

You can load $EDXLIST as a separate program. For example, if you select NOLIST and the 
statistics displayed at the end of the compilation indicate compilation errors, you can load 
$EDXLIST to print a hsting. 

You invoke SEDXLIST with the $L operator command. It requires two data set names: the source 
data set and work data set used for compilation. If you invoked $edxasm with the session 
manager, the work data set is named $SMiuser (where user is the sign-on ID). 

Note: If you want a listing of the latest compilation, use $EDXLIST before you invoke $edxasm 
again. Any subsequent compilation modifies the contents of the work data set. 

An example of using $edxlist follows: 



ii 



> $L $EDXLIST,ASMLIB 
SOURCE (NAME, VOLUME): ASMSRC ,EDX002 
WORKFILE (NAME, VOLUME): ASMWORK ,EDX002 

$EDXLIST 21P, 00:07:49, LP= 6500 

SELECT OPTIONS (?): ? 

LIST - SPECIFY LIST DEVICE 
ERRORS - LIST ERRORS ONLY 
END - END OPTION SELECTION 
{'ATTN - CA' TO CANCEL LISTING) 

SELECT OPTIONS (?): LIST 
DEVICE NAME: MPR I NTER 



^ 



SELECT OPTIONS (?): END 
SEDXLIST ENDED AT 00:08:46 



ii _p^ 



J 



Figure 15. $EDXLIST use example 



o 
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$EDXASM - Event Driven Language Compiler (continued) 

Invoking $EDXLIST with $JOBUTIL 

You can invoke $EDXLIST using the job stream processor $JOBUTlL The same options are 
available through the parm facility of $jobutil as were described under "Invoking $EDXLIST 
Manually with the $L Operator Command" on page UT-272. 

Example: Sample $jobutil procedure of invoking $edxlist 

PROGRAM $EDXLIST,ASMLIB 

NOMSG 

PARM LIST $SYSPRTR END 

DS ASMSRC,EDX002 

DS ASMWORK,EDX002 

EXEC 
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$EDXLINK - Linkage Editor 



The $EDXLINK program is a linkage editor that prepares programs to execute in an EDX system. 
Using $EDXLINK, you can format one or more separately assembled object modules into a 
nonrelocatable edx supervisor or a relocatable load module. 

With $EDXLINK you can: 

Produce a formatted storage map of the combined object modules. 

Include required routines from specified data sets. 

Define a single-level overlay structure for more efficient utilization of main storage. 

Define the number of overlay segments to execute in unmapped storage. 

Use interactive or noninteractive sessions. 

Run multiple hnks within the same session. 

Run from a terminal using the session manager or $L, or through $jobutil. 

Log all error and warning messages to your terminal and to your specified output device. 

Specify additional dynamic storage to improve the performance of $edxlink. 

Use GLOBALS as references to $SYSC0M. 
You can create object modules from any of the following EDX language processors to be input to 

$EDXLINK. 

The Event Driven Language compiler ($edxasm) 

The Series/ 1 assembler ($S1ASM) 

The FORTRAN compiler 

The COBOL compiler 

The Pascal compiler 

The PL/I compiler 

Series/ 1 host assembler 






ij() 
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$EDXLINK - Linkage Editor (continued) 



Required Data Sets 



$EDXLINK requires one work data set (dsi). Used for symbol resolution, the data set must 
contain at least 256 records. Two types of errors can occur when using this data set, i/o errors 
and an end-of-file (eof). If an I/O error occurs, reallocate the data set to a different location on 
disk. If an end-of-file (EOF) occurs, the data set is too small. Reallocate the data set specifying 
a larger size. 

Note: You must restart the Unk process if either of these errors occurs. 

Optional data sets you may use when using $EDXLINK in a noninteractive mode are the 
primary-control-statement data set and the secondary-control-statement data set. 

• The primary-control-statement data set contains the control statements $edxlink will execute 
when running in noninteractive mode. It can contain secondary-control-statement data sets 
if you use the COPY control statement. 

• The secondary-control-statement data set contains additional control statements that the 
primary-control-statement data set will use. These are common control statements that are 
used frequently for many different link edits. 



$EDXLINK Control Statements 



Control statements are the instructions used by $edxlink to convert separately compiled or 
assembled object module(s) into an executable load module. You enter the control statements 
one at a time in interactive mode or write the entire set of link control statements to a 
Hnk-control data set for execution in noninteractive mode. 

The include, autocall, copy, overlay and unmapcnt statements specify what object 
modules you want link-edited and whether you want the load module to execute in mapped or 
unmapped storage or as an overlay. The remaining control statements affect the initiation and 
operation of the link-edit. 



Tallin'-"' 
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$EDXLINK - Linkage Editor (continued) 



The following are the $EDXLINK control statements used to perform a Unk-edit. 






AUTOCALL 

COPY 

END 

INCLUDE 

LINK 

OVLAREA 

OVERLAY 

RESET 

UNMAPCNT 

VOLUME. 

When you specify your control statements, the following order is recommended. 

All INCLUDE control statements for the resident portion of the program. 

An OVERLAY control statement followed by all include control statements for that overlay. 
The OVERLAY control statement is terminated by another overlay, an AUTOCALL, or a 
LINK control statement. 

The AUTOCALL control statement can appear anywhere prior to the LINK control statement. 

The LINK control statement initiates the Hnk edit. It must follow all control statements 
specifying the modules to be linked together. 



\^j^ 



Notes: 

1 . Each control statement, with the exception of the OVLAREA statement, may be abbreviated 
down to a minimum of two characters, ovlarea is abbreviated as ovl. 

2. A control statement starts in column one, and you must separate any operands by one or 
more blanks. 

3. You may use remarks on all control statements except for the AUTOCALL control statement. 
There must be at least one blank separating the control data and the remark. 

4. You may not continue control statement data on a second line. 



o 
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$EDXLINK - Linkage Editor (continued) 

* comment Statement 

Use the * comment statement to identify comments or remarks. 
Syntax: 



* THIS IS A COMMENT STATEMENT 



AUTOCALL Statement 






Use the autocall statement to identify autocall data sets. You can specify up to three autocall 
data sets. The linkage editor searches the autocall data sets in the order you specify on the 
AUTOCALL statement. You may not include remarks on the AUTOCALL statement. 

Syntax: 



AUTOCALL name, volume name, volume name,volume 

Required: none 

Default: no autocall processing 



If you specify the autocall statement multiple times, the last one is the one $EDXLINK uses. 
You can correct an error in the autocall statement by reentering the AUTOCALL statement. 
You can turn off the autocall option by specifying the autocall statement without an autocall 
data set. For more information see "AUTOCALL Option" on page UT-294. 

Examples: 



AUTOCALL $PLIAUTO 
AUTOCALL $AUT0,ASMLIB 

autocall $PLIAUTO,EDX002 $auto,asmlib 

autocall MYAUT0,MYV0L $PLIAUTO,EDX002 $auto,asmlib 

autocall <= turns autocall option off 
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$EDXLINK - Linkage Editor (continued) 



COPY Statement 



Use the copy statement to identify a secondary-control-statement data set from whicli to get 
additional control statements. The following control statements are permitted in a copy data 
set: 



INCLUDE 
OVLAREA 
OVERLAY 
VOLUME 



The system flags all other control statements with warning messages and ignores them. See 
"Using $EDXLINK Control Statement Data Sets" on page UT-295 for information on using 
existing $EDXLINK data sets. 

Syntax: 



COPY name,volume 

Required: name 

Default: volume defaults (see VOLUME) 



-J 



Examples: 



COPY NEXTOVLY 

COPY MORECNTL,EDX003 



\fc^ 
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$EDXLINK - Linkage Editor (continued) 



END Statement 



Use the END statement to identify the end of the control-statement data set. If the system 
encounters END in a primary-control-statement data set or if you enter it while in interactive 
mode, $EDXLINK ends. If the system encounters end in a secondary-control-statement data set, it 
ends processing of the COPY data set. 

Syntax: 



END 

Required: none 
Default: none 



INCLUDE Statement 



Use the INCLUDE statement to identify the object module(s) that $edxlink is to include in the 
generated output program. If you specify multiple object modules on the include statement, 
you must include the volume name. 

Syntax: 



INCLUDE name1,name2,name3,name4, , volume 

Required: namel 

Default: if a single data set name is entered, volume 
defaults to the IPL volume (see VOLUME) 



Examples: 



INCLUDE OBJECT 1 <= defaults to IPL volume 

INCLUDE OBJECT2,EDX003 <= one data set on EDX003 

INCLUDE OBJECTS, 0BJECT4, OBJECTS, EDX003 <= multiple data sets on 

volume EDX003 
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$EDXLINK - Linkage Editor (continued) 



LINK Statement 



U f 



Use the link statement to perform a link using the control statements previously processed. 
The name on the link statement is the name of the executable program to be generated. Upon 
completion of a Unk, $edxlink returns to process more link control statements. 

Syntax: 



LINK name,volunne REPLACE END 

Required: name 

Default: volume defaults (see VOLUME) 



The REPLACE option causes the linkage editor to replace any program with the same name as the 
one specified on the LINK statement. If you do not specify REPLACE (or r) and a program with 
the same name exists, you are prompted for replace. If you answer yes to the prompt, the 
linkage editor replaces the program. If you answer no to the prompt, the linkage editor prompts 
for a new program data set name. If you do not wish to generate the program, enter end and 
$EDXLINK does not generate a program but generates a link map. The end option ends 
$EDXLINK after completion of the link. 

You must consider the following when you invoke $edxlink through $jobutil: 

1 . When invoked through $jobutil, SEDXLink runs in noninteractive mode. To replace an 
existing program with a newly generated program, be sure that you coded the replace 
option on your link statement. 



»^y 



To ensure that the $eDXLINK completion code generated as a result of the link edit is 
returned to $J0BUTIL, you must include an end statement in the last link statement. 



Examples: 



LINK PGMTEST 

LINK SORT,EDX003 

LINK PATCH, ASMLIB REPLACE 

LINK PATCH2, ASMLIB REPLACE END 

LINK GRAPH2, ASMLIB END 
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$EDXLINK - Linkage Editor (continued} 



OVLAREA Statement 



Use the ovlarea statement to specify an overlay area used by overlay segments defined with 
the OVERLAY statement. You control the size and location of the overlay area by specifying the 
starting address (entry in the root segment) and the ending address (entry in the root 
segment). If you do not specify an overlay area, $edxlink automatically generates an overlay 
area large enough to contain the largest overlay segment specified in your program. 

Syntax: 



OVLAREA strtaddr endaddr 

Required: strtaddr endaddr 
Default: none 



Operands Description 

strtaddr Starting address (entry in root segment) of the overlay area. 

endaddr Ending address (entry in root segment) of the overlay area. 
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$EDXLINK - Linkage Editor (continued) 



OVERLAY Statement 



Use the overlay statement to identify the overlay segments. AH the include statements 
before the first overlay statement make up the root or resident segment of the program. After 
the first overlay statement, all include statements until the next overlay statement make up 
the first overlay segment, and so on until the system processes the link statement. If you enter 
an OVERLAY immediately following an overlay statement, the second one overrides the first 
one. 

Syntax: 



OVERLAY REUSABLE 

Required: none 
Default: not reusable 



You can specify that the overlay segment is reusable by coding reusable on the overlay 
statement. Not reusable is the default. If you code reusable and issue a call to the overlay 
segment, the system loads the overlay only if it is not already in storage. The default 'not 
reusable' causes the system to load the overlay segment each time you issue a call to this 
overlay segment. 

Examples: 






OVERLAY 

OVERLAY REUSABLE 



RESET Statement 



Use the RESET statement to reset $edxlink. The system ignores all previous control statements. 
RESET is only valid in interactive mode. You receive a warning if it is found in a control 
statement data set. 

Syntax: 



RESET 

Required: none 
Default: none 



\J 
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$EDXLINK - Linkage Editor (continued) 



UNMAPCNT Statement 



Use the UNMAPCNT statement to specify the number of overlay segments associated with a 
specific program that will reside in unmapped storage. This statement causes $edxlink to bring 
in an overlay manager to handle the overlay segments in unmapped storage. 

If you do not specify the number of overlay segments or specify only one overlay segment, the 
system ignores the unmapcnt statement (no unmapped storage will be used) and the link 
proceeds. 

If the link is a supervisor Hnk, the system does not allow unmapped storage and $edxlink issues 
the following message: 






WARNING - NO UNMAPPED STORAGE CAN BE USED FOR A SUPERVISOR 



J 






Syntax: 



UNMAPCNT number 

Required: number 
Default: none 



Operands Description 

number The number of overlay segments to reside in unmapped storage. 

Examp/e: 



UNMAPCNT 5 



Chapter 4. Utilities UT-283 



$EDXLINK 

$EDXL1NK - Linkage Editor (continued) 



VOLUME Statement 



Use the VOLUME statement to set the default volume for all $edxlink control statements. 
Initially the default is the IPL volume. If you don't specify a volmne name on the volume 
statement, the system resets the default to the IPL volume. 

Syntax: 



VOLUME volume 

Required: none 
Default: IPL volunne 



Examples: 



VOLUME EDX003 
VOLUME OBJVOL 
VOLUME 



<= reset to IPL volume 



$EDXLINK Primary-Controi-Statement Data Set 



The following is an example of a multilink $edxlink primary-control-statement data set. The first 
link. Figure 16 on page UT-285, specifies that the executable program be linked without 
overlays. The second link, shown on the following page, specifies that the executable program 
be linked with overia3rs. It also references a secondary-control-statement data set. Figure 17 on 
page UT-286 . 






This example is shown in two parts for illustration purposes. You normally create it as one 
complete data set. 



\J 
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$EDXLINK - Linkage Editor (continued) 



C 



* PLOT PROGRAM INCLUDES 
* 

INCLUDE PLOTXY,MYVOL 

INCLUDE PLOTXX,MYVOL 

INCLUDE PLOTYY,MYVOL 

INCLUDE PLOTYX,MYVOL 
* 

* PERFORM AUTOCALL PROCESSING USING: 
* 

AUTOCALL MYAUTO,MYVOL $AUTO,ASMLIB 
* 

* PERFORM THE LINK 
* 

LINK PLOT,MYVOL REPLACE 

* ROOT SEGMENT INCLUDES 
* 

INCLUDE SORT1,EDX003 

INCLUDE SORT2,SORT3,SORT4, SORTS, OBJVOL 

INCLUDE SAVEMOD , BACKUP 

* 

* OVERLAY SEGMENT #1 INCLUDES 
* 

OVERLAY 

INCLUDE SEARCH, OBJVOL 

INCLUDE SCRATCH, BACKUP 

INCLUDE READSUB,WRITESUB,EDX003 
* 

* OVERLAY SEGMENT #2 WILL BE REUSABLE 
* 

OVERLAY REUSABLE 

INCLUDE PATCH, OBJVOL 

* GET OVERLAYS #3 AND #4 FROM SECONDARY CONTROL STATEMENT * 

* DATA SET (see Figure 17 on page UT-286) * 

COPY PACKUNPK,MYVOL 

* PERFORM AUTOCALL PROCESSING USING: 
* 

AUTOCALL $AUTO,ASMLIB 
* 

* PERFORM THE LINK AND TERMINATE $EDXLINK 
* 

LINK SORT,EDX003 REPLACE END 



Figure 16. Multilink $EDXLINK primary-control-statement data set 
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$EDXLINK - Linkage Editor (continued) 



$EDXLII\IK Secondary-Control-Statement Data Set 



The following is an example of a $EDXLINK secondary-control-statement data set. This 
secondary-control-statement data set was referenced in the previous example as PACKUNPK in the 
COPY statement. 



* THESE OVERLAYS ARE REQUIRED WHEN DATA 

* COMPRESSION/DECOMPRESSION IS USED 
* 

OVERLAY 

INCLUDE PACKDATA,BIGBUFF,OBJVOL 
OVERLAY 

INCLUDE UNPKDATA,BIGBUFF,OBJVOL 
END 



Figure 17. $EDXLINK Secondary Control Statement Data Set 



Specifying Dynamic Storage 



To increase program performance, you can change the dynamic storage used by $EDXLINK. 
$EDXLINK is shipped with an execution storage size of 22K. You can split this storage size 
(22K) between the program and dynamic storage. You can reduce the dynamic storage to a 
minimum of 8K (8192 bytes). If you specify any amount less than 8K, you will get 
unpredictable results. 



/0' ^ 



The following examples show how to change an 8K dynamic allocation area to lOK temporarily. 
The first example shows changing dynamic storage using the $L command. The second example 
shows changing dynamic storage using the $JOBUTlL utility. 



L 



> $L $EDXLINK,, 10240 



OR 



EXEC ST0RAGE=10240 



^kmJ^ 
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$EDXLINK - Linkage Editor (continued) 



To change dynamic storage permanently, load $diskut2 and perform the following: 



AsP.O'ttSOilS, LP= 0000 



V. 



> SL SDISKUT2 
LOADING $DISKUT2 

USING VOLUME EDX002 

C0MMAND(?): SS 

PROGRAM NAME: SEDXLINK 

ENTER NEW STORAGE SIZE IN BYTES 102^*0 

OLD STORAGE SIZE WAS 8192 

NEW SIZE WILL BE 102^40 

OK TO CONTINUE? Y 

COMMAND{?): EN 

$DISKUT2 ENDED AT 0^4:50:35 



J 



invoking $EDXLINK 



^\^ 
\i^ 



You can invoke $edxlink with the $L operator command, the job stream processor ($JOBUTlL), 
or option 7 of the session manager. 

Invoking $EDXLINK with the $L Operator Command 

The following are examples of invoking $edxlink with the $L operator command. (For 
examples of using the session manager, see the Event Driven Executive Language Programming 
Guide.) After you load $edxlink, the system prompts you for execution parameters (PARM). 
There are two parameters that you may specify for use with $EDXLINK: 

1. name,volume - specifies the primary-control-statement data set, and 

2. printer - specifies where to direct the printed output. 

The two parameters are positional. The primary-control-statement data set name must come first, 
optionally followed by the printer name. The printer name can be separated by one blank only 
from the name of the primary control statement data set name. If you do not code a printer 
name, it defaults to $SYSPRTR. If you enter END for the primary-control-statement data set name, 
$EDXLINK ends. 

To run $edxlink interactively, enter an asterisk (*) for the primary-control-statement data set 
name. 
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Invoking with $L Noninter actively: The following is an example of invoking $edxlink 
noninteractively. The linkwork data set, used by $edxlink as a work file, must contain at 
least 256 records. 



r 



> $L $EDXLINK 

LINKWORKlNAME. VOLUME): l I NKW0RK,EDX002 
LOADING $EDXLINK 88P ,00:00: 33 , LP^OOOO, PART=1 



A 



$EDXLINK • 
PARM (?): 



EDX LINKAGE EDITOR 



ENTER A LINK CONTROL DATA SET NAME, VOLUME OR AN 
ASTERISK {"), FOR INTERACTIVE MODE. A PRINTER 
DEVICE NAME MAY OPTIONALLY BE ENTERED AFTER THE 
LINK CONTROL DATA SET NAME, VOLUME. 

PARM (?): LINK1,EDX003 MPRINTER 

$EOXLINK CONTROL STATEMENT PROCESSING STARTED 
$EDXLINK EXECUTION STARTED 
CASE ,EDX003 STORED 
PROGRAM DATA SET S I 2E = 39 
COMPLETION CODE = -1 



V. 



$EDXLINK ENDED AT 00:01:12 



Invoking with $L Interactively: The following is an example of a multilink interactive 
session. The storage parameter is specified to take advantage of $EDXLINK'S use of dynamic 
storage. This example is broken into three parts for illustrative purposes. You normally create it 
as one data set. 

Part 1 displays all the $edxlink control statements, Unks one module, contains no overlays, and 
runs to a successful completion (-1). 



\^J 
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$EDXLINK - Linkage Editor (continued) 






> SL SEDXLINK, ,20000 

L I NKWORK( NAME, VOLUME): L I NKW0RK,EDX002 
LOADING $EDXLINK 120P ,0^:00: 59, LP=0000, PART=1 

$EDXLINK - EDX LINKAGE EDITOR 



PARM (?): ""' SSYSLOG 

SEDXLINK INTERACTIVE MODE 
DEFAULT VOLUME = EDX002 

STMT (?): ? 

SEDXLINK CONTROL STATEMENTS 

AUTOCALL - SPECIFY AUTOCALL DATA SET(S) 

COPY - COPY THE SPECIFIED CONTROL STATEMENTS FROM DSNAME .VOLUME 

END - TERMINATE SEDXLINK 

INCLUDE - INCLUDE THE FOLLOWING MODULE(S) 

LINK - GENERATE AN EXECUTABLE PROGRAM 

OVERLAY - SPECIFY THE BEGINNING OF AN OVERLAY SEGMENT 

OVLAREA - SPECIFY LOCATION OF OVERLAY AREA 

RESET - RESET SEDXLINK 

VOLUME - CHANGE DEFAULT VOLUME 

UNMAPCNT - SPECIFY NUMBER OF UNMAPPED STORAGE OVERLAYS 

STMT (?): INCLUDE TESTSUB4 ,EDX003 

STMT (?): LINK CASE ' ,£0X003 REPlACE 

SEDXLINK EXECUTION STARTED 
CASE1 ,EDX003 STORED 
PROGRAM DATA SET SIZE = 12 
^COMPLETION CODE = -1 

Figure 1 8. $EDXLINK multilink interactive interface 

Part 2 of this example is the same as part 1 except that it hnks multiple data sets. They are all 
listed on the same INCLUDE control statement because they reside on the same volume. 

SEDXLINK INTERACTIVE MODE 
DEFAULT VOLUME = EDX002 

STMT (?): INCLUDE OBJ 12 ,OBJ 1 3 ,0BJ 1^ ,03J 1 5 ,EDX003 
STMT (?): LINK pGM1,EDX003 REPLACE 

SEDXLINK EXECUTION STARTED 
PGMl ,EDX003 STORED 
PROGRAM DATA SET SIZE = 15 
COMPLETION CODE = -1 



Part 3 of this example contains multiple overlay segments. The root section is named TESTROOT, 
and the three overlays are testsubi,testsub2, and testsub3. testsub3 is reusable. The 
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$EDXLINK - Linkage Editor (continued) 



AUTOCALL data set is used in this example, and an end statement is specified on the link 
statement to end the $edxlink session. 



r 



$EOXLINK INTERACTIVE MODE 
DEFAULT VOLUME = EDX002 



STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 
STMT (?) 



INCLUDE TESTR0OT,EDX0O3 

OVERLAY 

INCLUDE TESTSUB1,EDX003 

OVERLAY 

INCLUDE TESTSUB2,EDX003 

OVERLAY REUSABLE 

INCLUDE TESTSUB3,EDX003 

AUTOCALL $AUTO,ASMLIB 

LINK TEST,EDX003 REPLACE END 



$EDXLINK EXECUTION STARTED 
TEST ,EDX003 STORED 
PROGRAM DATA SET SIZE = 26 
COMPLETION CODE = -1 

SEDXLINK ENDED AT Oi>:05:35 



Invoking $EDXLINK with the Job Stream Processor 



The following are examples of invoking SEDXLINK with the job stream processor ($jobutil). 
You can specify two parameters on the $jobutil parameter statement: 

1 . name, volume - specifies the primary-control-statement data set, and 

2. printer - specifies where to direct the printed output. 

The two parameters are positional. The primary-control-statement data set must come first, 
optionally followed by the printer name. The printer name can be separated by one blank only 
from the primary-control-statement data set name. If you do not code a printer name, it 
defaults to the $sysprtr. 

To run $edxlink interactively from $jobutil, enter an asterisk (*) for the 
primary-control-statement data set name. 
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$EDXLINK - Linkage Editor (continued) 

Invoking with $JOBUTIL Noninteractively: In this example, di primary-control-statement 
data set called LINKI on EDX003 is specified and the printed output is defaulted to $SYSPRTR. The 
storage parameter is also specified to take advantage of $EDXLINK's use of dynamic storage. 

JOB LINK2 

PROGRAM $EDXLINK 

DS LINKWORK,EDX002 

FARM LINKI, EDX003 

EXEC STORAGE=20000 

EOJ 

invoking witii $JOBUTIL Inter activeiy: In this example, $edxlink is to be run 
interactively. The printed output is directed to mprinter. 

JOB LINKI 

PROGRAM $EDXLINK 

DS LINKWORK,EDX002 

FARM * MPRINTER 

EXEC 

EOJ 

Operator Termination of $EDXLIiMK 

To terminate $edxlink before a logical end of job, use the attention interrupts CA and RE. 

The CA attention interrupt is active at all times and returns control to the farm (?): prompt. 
You then have the option of ending $edxlink or starting a new session. 

The RESET (RE) control statement is only active in $EDXLINK interactive mode and returns 
control to the stmt (?): prompt. You then have the option of ending $edxlink or starting a 
new link. 

Note: If you are in interactive mode and processing control statements, the stmt (?): prompt 
may appear before the cancel or reset take effect. Press the enter key again and the cancel or 
reset will proceed normally. 
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$EDXLINK - Linkage Editor (continued) 



$EDXLINK Output 



The link map is a listing that $edxlink generates. This listing corresponds with the example 
Figure 18 on page UT-289. The example is broken into three parts for illustrative purposes. 
You will see it as one listing when it prints. 

Part 1 shows all data sets included in the link-edit, and the message output generated by the 
execution of the link-edit. 



$EDXLINK EXECUTION CONTROL STATEMENTS 04:01:13 

FROM INTERACTIVE MODE 03/25/81 

INCLUDE TESTR00T,EDX003 

OVERLAY 

INCLUDE TESTSUB1,EDX003 

OVERLAY 

INCLUDE TESTSUB2,EDX003 

OVERLAY REUSABLE 

INCLUDE TESTSUB3,EDX003 

AUTOCALL $AUT0,ASMLIB 

LINK TEST,EDX003 REPLACE END 

$EDXLINK EXECUTION STARTED 

""" WARNING - UNRESOLVED WEAK EXTERNAL REFERENCES 

SVC SUPEXIT SETBUSY 
TEST ,EDX003 STORED 
PROGRAM DATA SET SIZE = 26 
COMPLETION CODE = -1 



fT' 






Figure 19. $EDXLINK map 

Part 2 shows the storage layout of the root section and the overlay segments. It shows their 
entry points and sizes. The overlay area ($ovlarea) is determined by the largest overlay 
segment rounded up to the next page boundary. This is the section from which you get the 
overlay segment number. 
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$EDXLINK - Linkage Editor (continued) 
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0512 






TOTAL 


===> 


01D3 










OVERLAY SEGMENT: 3 














LABEL 


ADDR 


LNTH 


LABEL 


ADDR 


LABEL 


ADDR 


SECTION = 


0466 


01F2 










ENTRY = SUB3 


0468 












TOTAL 


===> 


01F2 











Part 3 shows the global section that is mapped to $SYSCOM when the program is loaded. 



GLOBAL SECTION(S): 






SECTION = COMMAREA 


0000 


0028 


TOTAL 


===> 


0028 


END OF MAP 
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$EDXLINK - Linkage Editor (continued) 



AUTOCALL Option 



Autocall Data Set 



The autocall option enables you to include modules that are not included explicitly via the 
INCLUDE statement. To invoke the autocall option, enter an autocall before the link 
statement specifying one to three autocall data sets. 



The autocall data set contains a list of object module names and volumes along with their entry 
points. 



Autocall Data Set Record Format 



The format of the autocall data set record is shown below. Each record must contain an object 
module "name,volume" beginning in column one and followed by at least one entry point. You 
must insert at least one blahk between the object module "name,volume" and the entry point, 
and at least one blank between each entry point. If you have more entry points than can fit in 
one record, specify an additional record beginning with the object module "name,volume" 
followed by the remaining entry points. Finally, you must end the autocall data set with **end 
in either the object module name field or an entry point field. 

The following are examples of the format of the autocall data set record. 



SORT,EDX003 INPUT OUTPUT RETCODE 
PATCH, OB JVOL ADDRESS LENGTH TYPE 
**END 



/f"^ 
W.-/ 



System Autocall Data Set 



The system autocall data set $auto is distributed with the Event Driven Executive Program 
Preparation Facility and installed on the volume ASMLIB. The data set contains the name of the 
modules and entry points that you can autocall as a result of including the following functions in 
your program: 

• graphics formatting instructions 

• data formatting instructions 

• square root function 

• screen formatting subroutines. 
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$EDXLINK - Linkage Editor (continued) 



Autocall Processing 



If you specify any autocall data sets and unresolved external references (extrn'S) remain after 
normal INCLUDE statement processing, the linkage editor searches the autocall data sets in the 
sequence that you specified. If external references match entry points in an autocall data set, 
the indicated object module is included with the resident segment. The linkage editor terminates 
autocall processing when no unresolved external references (extrn'S) remain after include 
statement processing or no matches are found in any of the autocall data sets. 



Unresolved External References 



The system lists all unresolved external references after the $edxlink processing messages. 
Any unresolved extrns cause SEDXLINK to return a completion code of 4. 

Unresolved weak external references (wxtrn's) do not invoke autocall processing. Unresolved 
WXTRN'S have no effect upon the $edxlink completion code. 



Using $EDXLINK Control Statement Data Sets 






To use existing $edxlink control statement data sets without changing them, do the following in 
interactive mode: 

Enter the copy statement followed by the sedxlink control statement data set name and 
volume. A warning message appears in reference to the OUTPUT statement from the 
SEDXLINK control statement data set, causing the system to return a completion code of 4. 

If the OUTPUT statement had the AUTO= parameter coded, enter the autocall statement 
followed by the autocall data set name and volume that appeared on the OUTPUT statement. 

• Enter the link statement with the executable program name and volume. 

Example: 

r 

SEDXLINK INTERACTIVE MODE 
DEFAULT VOLUME = EDX002 

STMT (?): COPY PGML I NK ,SRCV0L 

OUTPUT PGM1,EDX003 MAP AUTO=$AUTO ,ASML I B 

"'■"■'• WARNING - INVALID CONTROL STATEMENT - STATEMENT IGNORED. 

STMT (?): AUTOCALL $AUTO,ASMLIB 

STMT (?): LINK PGM,EDX003 REPLACE END 

SEDXLINK EXECUTION STARTED 
PGM ,EDX003 STORED 
PROGRAM DATA SET SIZE = 15 
COMPLETION CODE = k 
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$FONT - Process Character/Images Tables 

$FONT creates or modifies the character image tables for the 4978 and 4980 display stations and 
the 4974 matrix printer. The image stores in these devices contain bit patterns that are 
interpreted by the hardware to produce the display or printing of characters. Each character bit 
pattern corresponds to an EBCDIC code, which is defined by a dot matrix coded into eight bytes 
of data for the 4974 and 4978 and 16 bytes of data for the 4980. You can change Character bit 
patterns to alter the appearance of existing characters in a device's image store or to create 
entirely new characters. 

For the 4978 and 4980, you can modify the system-supplied image store data sets $4978180 and 
$4980180 by using $FONT. The system automatically loads these data sets to every 4978 and 
4980 display station supported by the supervisor when you IPL your system. Any changes you 
make to the system-supplied data sets are reflected in all the 4978 or 4980 display stations 
attached to your Series/ 1 . If you create a new image store and save it in a data set different 
than the system-supplied data set, you can load the image store to the display station of your 
choice. 

You can change a 4978, 4980, or 4974 image table using either a 4978, 4980, or 4979 display 
station. 

Data Set Requirements 

To create a new image store, you must allocate an image store data set before using $font. The 
system uses this data set to save the newly-created image store. Use $diskuti to allocate the 
data set. 

Depending upon the size of the image store (device-dependent) you intend to create, we 
recommend the following data set sizes according to device type: 






\ 






Invoking $FONT 



4974 768 bytes (3 records) 

4978 2048 bytes (8 records) 

4980 4096 bytes (16 records) 

You invoke $F0NT with the $L operator command or option 4.5 of the session manager. 



> $L SFONT 
LOADING $FONT 66P , 17:01 : 1 1 , LP= 0000, PART= 3 



After you load $FONT, it prompts you for the name of an existing image store. 
I DATA SET (NAME .VOLUME): 
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$FONT - Process Character/Images Tables (continued) 



After you enter the data set name and volume, $font issues the following message: 



DATA SET FORMATS: 

1) 4980 

2) 4978 

3) h31k 

SELECT OPTION: 



Enter the appropriate option depending upon the type of image store you intend to create or 
modify. The device type must match the format of the image-store to be read into the storage 
work area reserved by $font. For example, if you intend to modify a 4980 image store, select 
option 1. 



Once you have selected the appropriate option, $FONT reads the contents of the image store data 
set into the storage work area. 



$FOIMT Commands 






To display the $font commands at your terminal, enter a question mark in response to the 
prompting message command (?): as shown below. 





A 



*^. 



COMMAND 


(?): ? 


DISP -- 


DISPLAY IMAGES 


READ -- 


READ IMAGE DATASET 


SAVE -- 


WRITE IMAGE DATASET 


EDIT -- 


ENTER EDIT MODE 


PUT -- 


PUT IMAGE STORE INTO DEVICE 


GET -- 


GET IMAGE STORE FROM DEVICE 


END -- 


END $FONT 


COMMAND 


(?): 



After $FONT displays the commands, it again prompts you with command (?): 
respond with the command of your choice (for example, edit). 



Then you can 



You can enter the commands in abbreviated format; for example, you can enter R instead of 
READ. Each command and its explanation is presented in alphabetical order on the following 
pages. Each description shows the abbreviation and full word for each command. 



DISP (D) — Display Images 



Use the DISP command to display the characters generated for each EBCDIC code by the 
associated bit patterns in the image store. There are 256 EBCDIC codes. Not all devices support 
this number of characters. The utility displays only the characters that it supports, leaving the 
rest blank. (For descriptions of the characters supported by the 4974 matrix printer and the 
4978/4980 display stations, see the 4974 Printer Description, the 4978 General Information, and 
the 4980 General Information manuals.) 
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$FONT - Process Character/Images Tables (continued) 

Notes: 

1. You can restore the image buffer (wire image table) of the 4974 to the standard 
64-character set by using the RE command of $termut2. 

2. You can restore the image buffers for the 4978 and 4980 using the li of $termut2. 

Example: This screen display is in compressed format and does not show the entire image 
table as it would appear. Note the use of the get command prior to disp. 






COMMAND (?): q^-t 
TERMINAL NAME : [353 |_/^y 1 



COMMAND (?) 



DIS? 



00 10 20 30 AO 50# 60- 

01 11 21 31 ^1 51 61 

02 12 22 32 hi 52 62 

03 13 23 33 ^3 53 63 

04 \k Ik 25 kh Sk 64 

05 15 25 35 45 55 65 



OD ID 2D 3D 4D( 5D) 6D- 
OE IE 2E 3E 4E+ 5E! 6E> 
OF IF 2F 3F 4F| 5F 6F? 



V^ 



CO DO EO 
CIA D1J El 



CD 
CE 

CF 



DD 
DE 
DF 



ED 
EE 
EF 



PRESS ENTER TO CONTINUE 



FOO 

Fll 



C2B D2K E2S F22 

C3C D3L E3T F33 

C4D D4M E4U Tkk 

C5E D5N E5V F55 



FD 

FE 
FF 



J 



"^ 

V 



The system displays the EBCDIC characters to the right of their associated hexadecimal codes. 

To end display mode, press the enter key; $font issues the command (?): prompt again. Then 
you can enter the edit command to modify or create a character. 

Notes: 

1. Whenever you use a 4979 to modify an image store, the disp command displays the 
character set of the 4979. 

2. If you display a character set formatted for one type of terminal on a different type of 
terminal (for example, if you display a 4980 character set on a 4978), the message 
CHARACTER APPROXIMATIONS a; re a I the bottom of the display. This means that the 
characters displayed are only representations for the actual characters defined for the 
terminal. 



o 
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$FONT - Process Character/Images Tables (continued) 



EDIT (ED) — Enter Edit Mode 



Use the EDIT command to create a new image table or to modify an existing image table. 
Depending upon the device type, $font displays a dot matrix pattern (a 4 x 8 grid for the 4974 
and 4978 or an 8 x 14 grid for the 4980). You can specify the character you want to appear on 
the grid for modifications. The image on the grid shows the changes you make as you modify or 
create a character. 

After you finish creating a new image table or modifying an existing one, you need to save the 
image table or load it into a device. Use the SAVE command to save it in a specified data set or 
the PUT command to load the table into a specified device. 

Example: Edit a 4980 image control data set. 



"X^ 



COMMAND 


(?): ED 


PFl 


TAB FORWARD 


PF2 


TAB BACK 


PF3 


TAB DOWN 


ppZ, 


INVERT DOT 


PF5 -- 


CANCEL/END 


ENTER -- 


SET PATTERN 



CODE 



^ 



For an explanation of changing or creating characters, see "Create/Modify a Character Image" 
on page UT-306. 
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$FONT - Process Character/Images Tables (continued) 

END (EN) — End the $FONT Utility 

Use the END command to end the $font utility. 



L 



COMMAND (?): g^ 



If you created or modified an image store and did not save the contents of the storage work 
area, $FONT prompts you as follows: 



L 



SAVE TABLE? 



If you respond Y, $F0NT prompts you for the name of the data set in which to save the contents 
of the storage work area. 



L 



DATA SET (NAME, VOLUME) 



This gives you another opportunity to save the contents of storage work area. 

If you respond N, $FONT ends. The contents of the work area are no longer available. 



o 
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$FONT - Process Character/Images Tables (continued) 



GET (G) — Get Image Store from Device 






Use the GET command to get the contents of an image store from a 4978, 4980, or 4974 
terminal and place them into the storage work area reserved by $font. After you get the image 
store into the work area, you can display it with the disp command or modify it using the edit 
command. 



I: 



COMMAND (?): GET devname 



Enter the name of the device (specified on the terminal statement) whose image store you 
want read into the work area. 

If you do not specify a device name on the same line as the GET command, $FONT prompts you 
as follows: 



L 



ENTER TERMINAL NAME (CR OR " = TH I S ONE) 



If the system cannot find the requested terminal, $font issues the following message: 
I NOT ONLINE, ANOTHER NAME? 

If you respond Y, $font prompts you for another terminal name. If you respond N, $font 
issues the command (?): prompt. 

If you enter the name of a terminal that is not a 4978, 4980, or 4974, $font issues the following 
messages: 

UNSUPPORTED DEVICE 
COMMAND {?): 






Examples: 



COMMAND (?): GET 

ENTER TERMINAL NAME: DSPLAYl 



COMMAND (?): GET DS^LAYl 
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$FONT - Process Character/Images Tables (continued) 

PUT (P) — Put Image Store into Device 

Use the PUT command to load a device with the contents of the work area. 

Notes: . 

1 . The image table will revert to its original state when you initialize the system again or if a 
power failure occurs. 

2. You can also load a specified device with an altered or new image table by using the Li 
command (load an image store) of the $termut2 utility. 



L 



COMMAND (?): PUT device 



Enter the name of the device (specified on the terminal statement) you want loaded with the 
new or modified image table. 

If you do not specify a device name on the same line as the put command, $font prompts you 
as follows: 



L 



ENTER TERMINAL NAME (CR OR * = THIS ONE) 



/If ^IN 

If you attempt to load a 4974 printer with an image store greater than 96 characters (for ^«m^ ,j^ 

example, a 4978 image store of 98 characters), $font issues the following message: 

THE FIRST 96 NONBLANK CHARACTERS OF THE 
IMAGE STORE WILL BE PUT TO THE k31k. 

CONTINUE? (Y/N) 



If you respond Y, the system loads into the 4974 only the first 96 nonblank characters it 
encounters. If you respond N, $font issues the command (?): prompt. 
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$FONT - Process Character/Images Tables (continued) 



If you attempt to load a 4974 with a 4980 image data set, $font sends the characters 
corresponding to a fixed set of 96 EBCDIC codes. These codes are listed in the following 
message: 



THE EBCDIC HEX CODES OF THE UgSO 
CHARACTERS ABOUT TO BE PUT TO THE '497^ ARE: 



6F 



^ 



4A 


• • . 


kf 






50, 


5A 




5E 


60, 


61 


, 6A 




7A 




7F 




81 




89, 


8F 


91 




99 




Al 




A9 




BO, 


BA 






CO 




C9 




DO 




09 




EO, 


E2 




E9 




FO 




F9 






CONTINUE? 


(Y/r 









If you respond Y, the system loads the EBCDIC characters associated with the hexadecimal codes 
into the 4974. If you respond N, $font issues the COMMAND (?): prompt again. 

Examples: 



COMMAND (?): PUT 
TERMINAL NAME: DS=LAY1 



V 



COMMAND (?): ^UT DSplAYI 
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$FONT - Process Character/Images Tables (continued) 

READ (R) — Read Data Set 

Use the read command to read the contents of an image store data set into the storage work 
area reserved by $font. $F0NT prompts you for the data set format. 



DATA SET FORMATS; 

1) 4980 

2) 4978 

3) h31k 

SELECT OPTION: 



The device type must match the format of the image-store data set. After the system reads the 
image store into the storage work area, you can display it by using the DISP command or modify 
it by using the EDIT command. 

Example: Read an image store into the storage work area. 

COMMAND (?): READ MYDATA.MYVOL 
DATA SET FORMATS: 

1) i»980 

2) 4978 

3) kVk 

SELECT OPTION: 






J 



If you don't specify the volume name, it defaults to the volume from which $font was loaded. 



"~^ 



UT-304 SC34-0644 



$FONT 



o 



$FONT - Process Character/Images Tables (continued) 

SAVE (S) — Write Image Data Set 

Use the SAVE command to save the contents of the storage work area reserved by $F0NT to a 
specified data set. The format of the data set must match the format of the image store 
currently in the storage work area. You can use the save command to initialize an empty data 
set or to replace the contents of a data set that has been used before. If you save the contents in 
an existing data set, you no longer have access to the previous contents. 

Example: In the following example, the first attempt to save an image store IMAG80 (a 4980 
image store) in a data set formatted for a 4974 is invalid. $font prompts for another data set. 
The second save attempt is successful because the work data set format matches the current 
image store type (in this Case, a 4980 image store). 






COMMAND (?): j 

DATA SET (NAME, VOLUME): imAG80 

DATA SET FORMATS: 

1) ^4980 

2) '»978 

3) h31k 

SELECT OPTION: 3 

INVALID SAVE 

DEVICE MUST MATCH DATA SET 

ANOTHER DATA SET? (Y/N) Y 

DATA SET (NAME. VOLUME): imAGBO 

DATA SET FORMATS: 

1) 4980 

2) 4978 

3) h31k 

SELECT OPTION: , 

CURRENT DATA SET IS I MAG80,EOX002 
FORMATTED FOR 4980 

REPLACE? (Y/N) y 
COMMAND (?): 



o 
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$FONT - Process Character/Images Tables (continued) 

Create/Modify a Character Image 

Use the edit command to make changes to characters or to create new characters. In edit, you 
can choose a specific character to be displayed on a grid and can make changes to that 
character. The grid shows all changes. The grid remains blank until you specify the EBCDIC 
character and/or hexadecimal code. 

In this example, a 4978 or 4974 image store is to be modified. 



COMMAND (?): EDIT 



PFl 

PF2 

PF3 
PF/4 

PF5 - 
ENTER -- 

CODE 



TAB FORWARD 
TAB BACK 
TAB DOWN 
INVERT DOT 
CANCEL/END 
SET PATTERN 

(00) 





(Screen 1) 





































































Note the position of the cursor: it is located just to the right of the code prompt. Enter the 
character you wish to modify next to the code prompt. Enter the character's corresponding 
hexidecimal code in the parentheses to the right of the cursor. 

Function of the PF Keys 

Use the pf keys listed on the screen to move the cursor and make modifications to the character 
on the grid. The pf keys and their functions are as follows: 

PFl Moves the cursor forward (left-to-right and top-to-bottom) across the grid. 

PF2 Moves the cursor backwards within the grid (right-to-left and bottom-to-top). 

PF3 Moves the cursor from its present Une down to the next line. 

PF4 Inverts the dot pattern. 

PF5 Returns you to command mode or cancels the current edit session. Press PF5 once to 
cancel the edit session. Press pf5 a second time to return to command mode. 






o 
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$FONT - Process Character/Images Tables (continued) 

Function of the Enter Key 

The enter key has an important use when you're editing. Press the enter key when you are 
finished making changes to the character on the grid. $font issues the following prompt: 









I 



REPLACE X (xx)? 



where x represents the EBCDIC character being modified and xx is the hexadecimal equivalent 
of the character. Enter Y to make the changed character part of the image store. Enter N if you 
want to associate the modified character with a different EBCDIC character or hexadecimal 
code. $FONT issues the following message: 



I 



SET TO NEW CODE? 



If you respond Y, $font prompts you for the new code as follows: 
I NEW CODE: _ (00) 

Enter the EBCDIC character and/or hexadecimal code with which you want the modified 
character associated. For example, if you want to associate a modified A (CI) with the B 
character, enter B (C2). 

If you respond N, $FONT assumes you do not wish to save the changed character and positions 
the cursor at the first line, leftmost corner of the grid. You can make additional changes to the 

character currently in the grid or press PF5 to move the cursor down to the CODE (00) prompt. 

Then enter the EBCDIC character and hexadecimal code of another character you wish to 
modify. 
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Example of Modifying a C/iaracter 






To specify a character to appear on the grid for modification: 

1 . Enter the desired character. You can also move the cursor to the right and enter the 
corresponding hexadecimal code, if known, between the parentheses. This example shows 
the letter T and its corresponding hexadecimal code. 

2. $FONT then fetches the bit pattern for the specified EBCDIC character or hexadecimal code 
and displays the corresponding character image in the grid. Screen 2 shows the letter, its 
hexadecimal code, and the resulting image of the T on the grid. 



COMMAND 


(?): EDIT 


PFl 


TAB FORWARD 


PF2 


TAB BACK 


PF3 -- 


TAB DOWN 


PF4 


INVERT DOT 


PF5 - 


CANCEL/END 


ENTER -- 


SET PATTERN 


CODE T 


(E3) 



(Screen 2) 



T 






J 



C 
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3. After the image appears on the grid, the cursor moves to the top left-hand square of the grid. 
The hexadecimal code for the character on the grid remains displayed in the parentheses to 
the right of the CODE prompt, as shown in Screen 3. ($FONT also displays the character in 
its actual size below the grid. The appearance of this character changes to reflect the 
changes to the character on the grid.) 



COMMAND 


(?): 


EDIT 


PFl 


TAB 


FORWARD 


PF2 


TAB 


BACK 


PF3 -- 


TAB 


DOWN 


PF4 


INVERT DOT 


PF5 -- 


CANCEL/END 


ENTER -- 


SET 


PATTERN 



CODE T (E3) 



(Screen 3) 



^ 



T 



With the cursor positioned as shown in Screen 3, use the PF keys to modify the letter T. 
this case, you are extending the top left and right sections of the crossbar. 



In 
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5. Press the PF4 key; you have inverted the dot pattern in the first square and extended the left 
end of the crossbar downward. The image on the grid changes as shown in Screen 4: 



vy 



COMMAND 


{?): 


EDIT 


PFl 


lAb 


FORWARD 


PF2 


TAB 


BACK 


PF3 -- 


TAB 


DOWN 


?vk 


INVERT DOT 


PF5 -- 


CANCEL/END 


ENTER -- 


SET 


PATTERN 



(Screen 4) 



CODE T (E3) 



T 



6. Press the PFl key to move the cursor across the grid into the top right square. Press the pf4 
key again to extend the right crossbar downward, as was done on the left side. 



i — >^ 



^^s^ilr 
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$FONT - Process Character/Images Tables (continued) 



7. Once changes to the character are complete, press the enter key. This changes the CODE 
prompt to REPLACE and positions the cursor just to the right of the replace prompt, as 
shown in Screen 5. 






(Screen 5) 



COMMAND (?): EDIT 



PF1 


-- TAB FORWARD 


PF2 


-- TAB BACK 


PF3 


-- TAB DOWN 


??k 


-- INVERT DOT 


PF5 


-- CANCEL/END 


ENTER 


-- SET PATTERN 



CODE T (E3) 



REPLACE T (E3)? 



T 



Now, you can either "set" the modified character as it appears on the grid into the image table, 
"cancel" all changes just made to the character, or "associate" the character with a key other 
than the one specified. 

1. To "set" the modified character into the image table, respond Y to the REPLACE prompt to 
replace the original T in the image table. 

2. To "cancel" the changes made to the character, respond N to the replace prompt and the 

SET TO NEW CODE prompt. 

3. To "associate" the character with a character other than the one specified, respond N to the 
replace prompt and then Y to the set to new code prompt. $font then prompts you for 
the EBCDIC character and hexadecimal code you wish to associate with the modified 
character. 

After any of the above actions, the replace prompt changes back to the code prompt and 
clears the grid, ending that editing session. The blank screen reappears (Screen 1 ) and you can 
specify another character for modification. 

To end edit mode, press pf5 and reenter command mode. If you want to be able to load the 
modified image table to a 4978, 4974, or 4980 at a future time, you must store the image table 
in a disk or diskette data set. Use the save command to store the new or modified image in the 
data set specified. 
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$FSEDIT- Full Screen Editor 



$FSEDIT is a full-screen text editing utility that helps you develop and modify source data. It 
operates the terminal as a static screen device and, therefore, must be run from a terminal with 
static screen capability (for example, 4978, 4979, 4980, or 3101 display terminals). 

With $FSEDIT you can: 

Edit or browse a data set using a full screen. 

Scroll information forward and backward. 

Use PF (program function) keys for frequently-used functions. 

Insert a mask for prefilling inserted lines. 

Merge data from other data sets. 

Print a data set. 

Display a directory list for a specific volume. 

Communicate with a System/370 in conjunction with the Host Communication Facility lUP 
installed on the host System/370. 

Note: To use $FSEDIT, the following modules must reside on the the same volume as $FSEDIT: 

$FSMEN, $FSEDB, $FSUT1 tO $FSUT4, $FSIMA, and $FSIMO tO $FSIM8. 



//"^X 

X.V 



Invoking $FSEDIT 



Invoke $fsedit with the $l operator command or option 1 of the session manager. If you are 
loading $FSEDIT from an application program or by using a $JOBUTiL procedure, you must pass 
$FSEDIT a 1-word parameter of zeroes. 

SFSEDIT requires a preallocated work data set. The system automatically allocates this work data 
set if you invoke $FSEDIT with the session manager. If you use the $L operator command to 
invoke $fsedit, the system prompts you for the name of the work file in the following manner: 



> SL $FSEDIT 
WORKFILE (NAME, VOLUME) 



See "Work Data Set" on page UT-315 for a description of the work data set. 
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$FSEDIT- Full Screen Editor (continued) 



After you enter the name of the work data set and press the enter key, $fsedit issues the 
following message if this is the first time you have used the work data set. 






DS1 HAS NOT PREVIOUSLY BEEN USED AS A WORK DATA SET 
IS IT OK TO USE IT NOW? 



Respond Y. If you respond n, $fsedit ends. 

Once you load $FSEDIT, it displays the following primary option menu. You then have the 
option of selecting one of the primary options or displaying a directory list for a specific volume. 



/T 



$FSEDIT PRIMARY OPTION MENU- 
OPTION ==> 

DATA SET NAME =========> 

VOLUME NAME ==========> 



■-STATUS = 
PRESS PF3 TO EXIT 



(CURRENTLY IN WORK DATA SET) 



HOST DATA SET =========> 

ENTER A VOLUME NAME AND PRESS ENTER FOR A DIRECTORY LIST 



^ 



BROWSE 

EDIT 

READ (HOST/NATIVE) 

WRITE (HOST/NATIVE) 

SUBMIT BATCH JOB TO HOST SYSTEM 

PRINT 

MERGE 

END 

HELP 



y 



The primary option menu has four input fields. They are the: 

• OPTION field 

• DATA SET NAME field 

• VOLUME NAME field 

• HOST DATA SET field 



Select Primary Options 



To select one of the $fsedit primary options, enter an option number in the option field. For 
example, if you enter a data set name and volume in the data set name and volume name 
fields and the number 3 in the option field, $fsedit reads the contents of the specified data set 
into the work data set. All subsequent $fsedit commands act upon the work data set. 
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Select Directory List 



You can also look at the list of directory entries (data-type data sets) on a specific volume. To 
do this, leave the option field blank, specify the name of a volume in the volume name field, 
and press the enter key. $fsedit displays a directory data set Ust of the specified volume. 

. 

VOL= WORK= CONTENTS= STAT = 

COMMAND INPUT ===> SCROLL ===> 

""** NAME **AAAAA:VAAAA LAST SAVED AT AAA'^"** USER "***" # OF LINE *"** 



The first line of the screen contains the following information: 

VOL = The volume for which the system displays the directory data set list. 

WORK = The name of the work data set. 

CONTENTS = The name of the source data set whose contents were copied into the work data 
set. 

STAT = The status of the contents of the work data set per the last action performed: 

UNCHANGED The contents of the work data set have not been modified. /^ 

INIT The work data set has been initialized. 

MODIFIED The contents of the work data set have been modified. 

SAVED The contents of the work data set have been saved. 

After $fsedit displays the directory list, you can use the directory data set list commands or you 
can browse or edit any of the data sets. See "Directory Data Set List Commands" on page 
UT-319 for a description of each command. 

To browse or edit a specific data set in the list, position the cursor next to the data set name in 
the directory list, enter B (browse) or E (edit), and press the enter key. $fsedit reads the 
contents of the data set into the work data set. You can now edit or browse the information in 
the work data set. (See "Option 1 — BROWSE" on page UT-327and"Option 2 — EDIT" on 
page UT-327 for a description of the browse and edit commands.) 

To obtain a hard copy of the directory data set list, use the $diskuti utility (LA or listp 
command). 
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Work Data Set 






$FSEDIT requires a preallocated work data set for use as a text edit work area. If you invoked 
$FSEDIT through the session manager, the session manager automatically allocates the work data 
set. Text data (source statements) within this work data set are in a special text editor format, 
identical to that used by the $EDIT1N text editor. See "Data Set Requirements" on page 
UT-235. You can edit data within a work data set with either $editin or $fsedit. 

Notes: 

1. $fsedit uses source data sets of 80-character lines that are line numbered in positions 73-80 
for host or Series/ 1 data sets. Positions 1-72 contain source data, and positions 73-80 
contain sequence numbers assigned by $fsedit for host or Series/ 1 data sets. The system 
pads these source statements to 128 bytes, and $fsedit stores them in source statement 
format (two 128-byte statements in each 256-byte record). 

The format of a $FSEDIT readable EDX record for source data sets is: 

Bytes Words Contents 

0-71 1-36 Source Line 

72-79 37-40 Line Number 

80- 1 27 41 -64 Zeros (reserved for future use) 

128-199 65-100 Source Line 

200-207 101-104 Line Number 

208-255 1 05- 1 28 Zeros (reserved for future use) 

2. The work data set should not be used by any other program. 

3 . The $FSEDIT utility uses a data set as a work area. During an edit session, the system saves 
the information you entered on the screen in a buffer area. Once this buffer area fills up, 
the system saves the contents in the work data set. If you ipl your system before you save 
the contents of the buffer in the work data set, the contents are lost. To avoid losing 
information in the buffer area, use option 4 (write) before iPLing your system. If you write 
the work data set to a tape, you no longer have access to previously existing data sets on 
that tape. 

When you end an editing session, save the contents of the work data set in a source data set on 
disk, diskette, or tape. To save the work data set contents, use the write command while in 
Edit mode or return to the primary menu and select option 4 (write). If the target data set 
does not exist on the volume specified, $FSEDIT creates it automatically. The system performs 
automatic translation from text editor format to source statement format. 
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Scrolling 



The information in the work data set and the directory data set list usually exceeds the size of 
the display screen. Scrolling allows you to page up or down through the information. Two pf 
keys are used for this purpose, one for each direction. A scroll amount is displayed at the end of 
the second line of the edit, browse, or directory list screen showing the number of Unes scrolled 
with each use of a scroll key. The scroll amounts are: 

PAGE or P Specifies scrolling one page (22 Unes). 

HALF or H Specifies scrolling a half page (11 lines). 

MAX or M Specifies scrolling to the top or bottom of the data set. 

n Specifies number of scrolling lines. 

In browse mode, the scroll amount is initialized to PAGE; in edit mode, it is initialized to half. 

You can change the scroll amount by moving the cursor to the scroll field and entering an 
amount over what is currently displayed. To change the scroll amount, type over the first 
character with a P, H, or M to change the scroll amount to a page, half page, or maximum, 
respectively. To specify a number of hnes to scroll, enter the number of lines you want. 

When you make a change, the new value remains in effect for the remainder of the session 

unless you change it again. The value for MAX is an exception; following a single MAX scroll, 

the scroll amount defaults back to the value for browse mode (page) or edit mode (half). \^.J^' 



"^ 



^^„iJr 
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$FSEDIT - Full Screen Editor (continued) 



Program Function Keys 

The ATTN and six program function keys are used to request commonly used or special $fsedit 
operations as follows: 



PFl 



PF2 



Redisplays the screen image. All changes are ignored and the original data is 
displayed as last entered before you pressed the PF key. 

SCROLL UP — scrolls towards the beginning of the data set by the amount shown 
in scroll amount field. 



PF3 

PF4 
PF5 

PF6 






ATTN CA 



SCROLL DOWN or END UTILITY — scroUs toward the end of the data set by the 
amount shown in the scroll amount field in edit mode or ends the $fsedit utility. 

REPEAT find — repeats the action of the previous find primary command. 

REPEAT CHANGE — repeats the action of the previous change primary 
command (appHes only to edit mode). 

PRINT screen — prints the screen image on the system printer ($SYSPRTR) or the 
hard-copy device defined with the HDCOPY= operand on the terminal 
statement. You can redirect the output to another printer using the PS (print 
screen) command. 

If the screen is printed, the message screen printed appears in the upper right 
hand column of the screen. If the printer is busy, the message printer busy 
appears in the upper right hand column of the screen. 

Cancel the print option. Pressing the attention key and typing CA stops the Ust 
option of $FSEDIT and returns to the primary menu. 



Notes: 

1. The PF2 - PF4 and PF6 keys are active only during browse and edit modes. Using PFl and PF5 
is only meaningful during edit mode. 

2. If you are using the starter system as your operating system and you have a 4979 display 
station at address 04, the program function keys operate as follows: 

PFl Redisplays the screen image. 

PF2 Repeat find. 
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$FSEDIT - Full Screen Editor (continued) 



PF3 


Scroll up. 


PF4 


Repeat change, 


PF5 


Scroll down. 


PF6 


Print screen. 



If you are using a 3101 terminal, the following additional program function keys are used: 

PF7 (Insert Mode only). This key performs the same function as the send key. Due 

to hardware restrictions, you must use this key as a Une terminator if you are 
performing multiple inserts. 

PF8 This key performs the same function as the 'ATTN' key on the 4978, 4979, and 

4980 display terminals. 



3101 Display Terminal Switch Settings 



If you are using a 3101 display terminal to edit or create programs, you can avoid operational 
problems with the 3101 terminal by setting the 3101 switches correctly. Refer to the 
Installation and System Generation Guide for detailed information on switch settings. Valid 
switch settings for your installation are found on the underside of the switch cover plate. 

If you require that the DUAL/MONO switches be set to dual, you can force command and L J 

program directives for the utilities or application programs to upper case by: 

• Pressing the shift key or 

• Using the CAPS command for the $FSEDIT edit session. 



^^jir 
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$FSEDIT - Full Screen Editor (continued) 

You should consider the following if you select dual case mode. 

• In an environment where there is a mix of terminal types, some terminals may not display 
lowercase characters. 

• Some printer types do not print lowercase characters. 

Directory Data Set List Commands 

$FSEDIT can display a list of the directory entries (data-type data sets that contain EBCDIC 
characters) on a specific volume. You can browse the Ust, sort the Ust by data set name or last 
date the data set was changed, locate a specific data set, or edit or browse the work data set or a 
specific entry on the list. 

To perform these functions, the following commands are available: 

B (BOTTOM) Scroll to the bottom of directory list. 

BR (BROWSE) Browse contents of the work data set. 

CV Change volume. 

ED (EDIT) Edit the contents of the work data set. 

E (END) Return to the previous menu. 

L (LOCATE) Locate a specific data set name. 

M (MENU) Return to the previous menu. 

S (SORT) Sort directory data set list. 

T (TOP) Scroll to the top of directory list. 

In addition to these commands, there are two Une commands that you can use when displaying 
the directory data set Ust: B (BROWSE) and E (edit). 

With the exception of the B (BROWSE) and E (edit) line commands, you can activate each of 
these commands by entering its name next to the command input prompt. See "Directory Line 
Commands" on page UT-325 for an explanation of using the B and E line commands. 

You can enter most of these commands in full or abbreviated form. For example, you can enter 
BR instead of browse. The abbreviated and full word command for each command, if 
appUcable, are shown on the following pages. 
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$FSEDIT - Full Screen Editor (continued) 



B (BOTTOM) - Display Bottom of Directory List 



Use the B (BOTTOM) command to display the end (bottom) of the directory list. This is 
equivalent to scroUing to the bottom of the list. 

Syntax: 



BOTTOM 
B 

Required: None 
Defaults: None 



BR (BROWSE) - Browse Contents of the Work Data Set 

Use the BR (BROWSE) command to examine the contents of the work data set. This command is 
equivalent to primary option 1 (browse). See "Option 1 — BROWSE" on page UT-327 for a 
description of the browse function. 

Syntax: 



BROWSE 
BR 

Required: None 
Defaults: None 



^. 



_y 



\J 
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CV — Change Volume 

Use the CV command to change the volume you are accessing currently. When you enter the CV 
command and the name of a volume, $FSEDIT displays the directory data set list of the specified 
volume. 



Syntax: 



CV volname 

Required: volname 
Defaults: None 






Operands Description 

volname The name of a volume (1-6 characters) 
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ED (EDIT) — Edit the Contents of the Work Data Set 

Use the ED (EDIT) command to edit the contents of the work data set. This command is 
equivalent to primary option 2 (edit). See "Option 2 — EDIT" on page UT-327 for a 
description of the function. 

Syntax: 



EDIT 
ED 

Required: None 
Defaults: None 



E (END) — Return to Primary Option Menu 

Use the E (end) command to end the current mode and return to the primary option menu. 
Syntax: 



END 
E 

Required: None 
Default: None 



V 
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$FSEDIT - Full Screen Editor (continued) 

L (LOCATE) — Locate a Specific Data Set Name 

Use the L (LOCATE) command to locate a specific data set name. 

You can also enter a generic name, that is, a prefix instead of an entire name. $FSEDIT searches 
through the Ust and locates the first data set starting with the specified prefix. 

Syntax: 



LOCATE dsname 
L dsname 

Required: dsname 
Defaults: None 



Operands Description 

dsname Name of the data set you want to locate. 



"\^ 



M (MENU) — Return to Primary Option Menu 

Use the M (menu) command to end the current mode and return to the primary option menu. 
Syntax: 



MENU 
M 

Required: None 
Default: None 



Chapter 4. UtiUties UT-323 



$FSEDIT 

$FSEDIT - Full Screen Editor (continued) 

S (SORT) — Sort Directory Data Set List 

Use the s (SORT) command to sort the display of the directory data set list. You can sort the list 
by date (last date the data set was updated) or by data set name (the default). 

Note: If a volume has more than 250 members, you can only sort the directory data set list by 
data set name. 

Syntax: 



SORT option 
8 option 

Required: option 
Defaults: None 



T (TOP) 



Operands Description 

option There are three sort options: 

DATE or D Sort the list by the date the data set was last updated. 

NAME or N Sort the list by data set name (the default). 

RESET or R Reset the current value of the sort option to NO SORT. 
Display Top of Directory List 

Use the TOP command to return to the beginning (top) of the directory data set list. 

Syntax: 






TOP 

T 

Required: None 
Defaults: None 



\J 
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$FSEDIT - Full Screen Editor (continued) 

Directory Line Commands 

Use the following line commands to browse or edit a data set on the directory data set list. 

B (BROWSE) Read the selected data set into the work data set and enter Browse mode. 

E (EDIT) Read the selected data set into the work data set and enter Edit mode. 

To select a specific data set, place the cursor next to the data set name in the directory Ust, enter 
E or B, and press the enter key. $FSEDIT reads the contents of the data set into the work data 
set. Now you can edit or browse the information in the work data set. See "Option 1 — 
BROWSE" on page UT-327 and "Option 2 — EDIT" on page UT-327 for a description of 
these commands. 

Example: Select a data set from the directory list to edit. 



VOL = EDX002 WORK = ED ITW0RK,EDX002 CONTENTS = TEST! STAT = 
COMMAND INPUT ===> SCROLL ===> 

AAA* NAME ************ LAST SAVED ******* USER ***** # OF LINES "*** 

TEST1 08/11/82 

TEST2 09/26/82 

E TEST3 07/22/82 

AAAAAAAAAAAAAAAAAAAAAAAAAAAA* BOTTOM OF DATA ********************** 



\ 
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Primary Options and Commands 

Under $FSEDIT, the following primary options are displayed on the primary menu: 
Option 1 - Browse Browse the contents of the work data set. 

Edit the contents of the work data set. 

Obtain a copy of a host/native data set and store it in the work data set. 

Transfer the contents of the work data set to a host/native data set. 

Submit a job to the host. 



Option 2 - Edit 
Option 3 - Read 
Option 4 - Write 
Option 5 - Submit 
Option 6 - Print 



Option 7 - Merge 

Option 8 - End 
Option 9 - Help 



Print the contents of the work data set on the device designated as 

$SYSPRTR. 

Merge all or part of a source data set with the contents of the work data 
set. 

End the $fsedit utility. 

Display tutorial text for using the $FSEDIT utility. 



A description of each option follows. 



'4j m 
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Option 1 — BROWSE 






Option 2 — EDIT 



Use option 1 (browse) to enter browse mode. In browse mode, you can look at source data in 
the work data set, but you cannot change it. 

You can look at all parts of the work data set by using the PF2 and PF3 program function keys. 
These keys enable you to scroll forward or backward through the data set. 

In addition, you can use two primary commands to locate specific information within the data 
set. 

FIND Searches for a designated text string. 

LOCATE Searches for a designated Une number. 

These primary commands are discussed under "Primary Commands" on page UT-334. 

During browsing, the current number of lines in your data set and the maximum number of lines 
the work data set can hold are displayed in parentheses on the top Une of the display, following 
the data set name and the volume identification. 

To end browsing, enter the primary command end or menu in the command input field and 
return to the primary option menu. 



In EDIT mode, you can modify an existing source data set or create a new one. To do this, you 
use: 

• Program function keys for two-way scroUing as well as repeat, change, and find; 

• Primary commands (CAPS, cancel, COBOL, change, clear, end, find, locate, menu, ps, 

RENUM, RESET, TABS, and WRITE); 

• Line edit commands to manipulate whole lines or blocks of Unes. (See "Edit Line 
Commands" on page UT-344 for an explanation of these commands.) 
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Creating a Source Data Set 

To create a new source data set, enter edit mode (option 2) with an empty data set (the work 
data set you specified when you invoked $fsedit) or use the CL (clear) command to clear the 
current work data set while in edit mode. Because the work data set is empty, the editor 
assumes you desire insertion (creation) of lines and activates the insert function. The 
following is an example of the initial display when you are editing an empty data set. 



r 



EDIT --- EDITWORK, EDX002 
COMMAND INPUT ===> 
'"""" """"" TOP OF DATA ""' 



0( Ik)— COLUMNS 001 072 
SCROLL ===>HALF 



..XJ-JLO, TCJLXJL 



BOTTOM OF DATA 



The top line of the screen, from left to right, displays utility mode (edit), the name and volume 
of the work data set (editwork,edxoo2), the number of source statements in the work data set, 
and the total number of statements the data set will hold (in parentheses). The COLUMNS 001 072 
indicates that the source data can only be entered in columns 1 through 72. 



The cursor is positioned at character position 1 of the insert line. After you enter information 
on this line, press the enter key. The utiUty then numbers the entered line and sets up for the 
next insert line. 

As you continue in this manner, a new insert hne is readied each time the preceding line is 
entered (by pressing the enter key). You can end the insert (creation) operation by pressing the 
enter key without entering anything on the new insert line. 






Note: $FSEDIT does not distinguish between insert mode and edit mode during editing 
operations, and you can change data on the screen at any time. 

There are two ways to save the source statements just created: 

1. In edit mode, enter the command write on the COMMAND input Une to save the contents of 
the work data set in the original (source) data set. If you want to save the work data set in a 
new data set, enter write data set,volume. 



I 



Exit edit mode by entering an M on the command input line and return to the primary 
option menu. Enter the number 4 (write) on the option Une to save the contents of the 
work data set in the original (source) data set. If you want to save the work data set in a 
new data set, enter the data set and volume name in the data set name and volume name 
fields. $fsedit prompts you as follows: 

WRITE TO dsname ON volname (Y/N)? 



If you respond Y, the contents of the work data set are saved in the data set specified in the 
DATA SET name and VOLUME NAME fields. If the data set does not exist on the volume 
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specified, $FSEDIT creates it automatically. If you respond N, $fsedit resets the menu and 
does not write the contents of the work data set to the specified data set. 

Modifying an Existing Data Set 

There are two ways to enter edit mode and modify an existing data set. If you use the primary 
option menu, the data set must be read first into the work data set using option 3 (read). If 
you use the directory data set list, move the cursor down to the desired data set name, type 'E' 
next to it, and press the enter key. Sfsedit reads the data set into the work data set. 

Locate and change information by scrolling the data set by pressing the pf keys. The pf keys 
and definitions are described under "Program Function Keys" on page UT-317. 

To modify data on the screen, move the cursor to the desired location and enter the new 
information. You can change several Unes before pressing the enter key. You can delete, insert, 
duplicate, or rearrange a single line or a block of lines with the edit commands. These are 
discussed under "Edit Line Commands" on page UT-344. 

For general editing purposes, you can use primary edit commands to find and change designated 
character strings and to change the Une numbering sequence. These commands are discussed 
under "Primary Commands" on page UT-334. 

After you finish modifying the contents of the work data set, you need to save it in the existing 
source data set or in another data set. You can perform the save from edit mode or from the 
primary option menu. 



There are two way to save statements just modified: 



1. In edit mode, enter the command write on the command input line to save the contents of 
the work data set in the original (source) data set. If you want to save the work data set in a 
new data set, enter write data set,volume. 

2. Exit edit mode by entering an M on the command input line and return to primary option 
menu. Enter the number 4 (write) on the option line to save the contents of the work 
data set in the original (source) data set. If you want to save the work data set in a new 
data set, enter the data set and volume name in the data set name and VOLUME name 
fields. $fsedit prompts you as follows: 



L 



WRITE TO dsname ON volname (Y/N)? 



If you respond Y, the system saves the contents of the work data set in the data set 
specified in the data set name and volume name fields. If the data set does not exist on 
the volume specified, $fsedit creates it automatically. If you respond N, $fsedit resets the 
menu and does not write the contents of the work data set to the specified data set. 

You can end the editing by entering the end or menu command in the command input field. 
end returns you to the previous menu; menu returns you to the primary option menu. 
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Editing Upper-Case and Lower-Case Character Data 

When you use option 3 (read), the system checks the entire data set for lowercase characters. 
This is done because lowercase data cannot be edited on a 4979, a 4978 or 4980 with an 
uppercase-only control store, or a 3101 with switches set for upper case. For information on 
how to change the 4978 or 4980 to a lowercase store see "$TERMUT2 - Change 
Image/Control Store" on page UT-557. For information on 3101 switch settings, see IBM 
3101 Display Terminal Description,, GAl 8-2033. 



If the system detects lowercase characters and you want to edit the data set using edit 
command, the following message is issued: 



WARNING, DATA SET ISN'T ALL UPPER-CASE CHARACTERS 
DO YOU WANT TO CONTINUE? 



J 



Entering an N causes a return to the primary option menu or directory data set list. 

Entering a Y causes the edit session to continue. If you decide to continue editing and are using 
an uppercase terminal, you lose only the lowercase data. To prevent the loss of data, you can 
issue CAPS ON ALL or CANCEL as the first primary command. 



If you issue the caps on all command, all data in the work file becomes upper case and no line 
commands or data changes are processed. The screen is reshown in upper case. 

Note: Setting CAPS ON all does not place change flags on the lines that are converted to upper 
case. 



u J 



If you use the CANCEL command, the edit session is cancelled, and you are returned to the 
primary option menu. If you use the end or menu command, the screen is processed and all 
lowercase characters are lost in the work data set. 

If the data set you read in is all uppercase data and you edit it adding lowercase data, the 
warning message is not issued. However, it is issued if the data set is written to source and then 
read in again. 

If you do a read command and then an edit, and the system detects lowercase data, the edit 
session begins in CAPS OFF mode. If the system finds no lowercase data, then the session begins 
in CAPS ON mode. 

Notes: 

1. Brackets [, 1, plus/minus ±, and bullet • EBCDIC representations on the 4978 and 4980 are 
treated as lowercase characters with no uppercase equivalents. The 4978, 4979, and 4980 
convert any unrecognizable character into a blank. 






UT-330 SC34-0644 






$FSEDIT 

$FSEDIT- Full Screen Editor (continued) 

2. On the 3101, brackets [, ], and not-signs are also treated as lower case and, when converted 
to upper case, are displayed as colons. The 3101 converts any unrecognizable character 
into a colon. 

3. The conversion from lowercase to uppercase characters takes place when you enter the 
primary command CAPS ON all in edit mode, or you alter a line containing one of these 
characters while in edit mode with CAPS ON. You cannot display these characters on a 4978, 
4979 or a 4980 with an uppercase-only control store or on a 3101 with switches set for 
upper case. 

4. The 'not-sign' hexadecimal representation on a 4978/4979 is equivalent to the 'caret' on a 

O 1 A1 



3101. 
5. The 'double bar' on the 4978, 4979, and 4980 is equivalent to the 'logical OR' on a 3101. 



Option 3 — READ 






Option 3 (read) retrieves a data set from either a host system or a data set on disk, diskette, or 
tape on the native Series/ 1 system and stores it in your work data set. The primary option menu 
remains on the display and the area below it is used to display how many lines were read from 
the source data set, the date and time of the last update to the data set, and your user 
identification if you invoked $fsedit through the session manager. The data set name entered 
must be fully qualified and must contain fixed-length, 80-byte records. 

Line numbers for native data sets must be in columns 73-80. For host data sets, line numbers 
can be in either columns 1-6 or 73-80. If the line numbers in the data set exceed the maxinium 
allowed by $fsedit (32767), the system automatically renumbers the data with a smaller line 
number increment. 

When READ completes or terminates because of an error, the number of lines transferred, or the 
appropriate error message, is displayed and the cursor is moved to the command input field. 
This indicates the completion of the read function, and you can select another option. The 
READ to host requires the Host Communications Facility on the System/370. 

When you do a read, $fsedit checks for lowercase data. See "Editing Upper-Case and 
Lower-Case Character Data" on page UT-330 for detailed information. 

Note: The system makes no attempt to verify that the data read is indeed source data. If the 
data is not source data, you can get unpredictable results. 



Option 4 — WRITE 



Option 4 (write) transfers the contents of the work data set to a host/native data set. Enter a 
4 in the option field and the name of the target data set and volume in the data set name and 
VOLUME NAME fields. $FSEDIT prompts you at the bottom of the primary option menu as 
follows: 



L 



WRITE TO dsname ON volname (Y/N)? 
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If you respond y, the contents of the work data set are saved in the data set specified in the 
DATA SET NAME and VOLUME NAME fields. If the data set does not exist on the volume 
specified, $fsedit creates it automatically. If you respond n, $fsedit resets the primary option 
menu and does not write the contents of the work data set to the specified data set. The write 
to host requires the Host Communications Facility on the System/370. 

Notes: 

1. The write option does not destroy the contents of the work data set. Therefore, you can 
direct write to another data set to obtain a backup copy. You can also use write following 
further editing of the work data set. 

2. If you increase the contents of the work data set so that it is too big to be written back to 
the source data set, $fsedit deletes the source data set and attempts to reallocate it with 
enough space to save the work data set contents. If the allocation fails, the original source 
data set is lost. However, the work data set remains intact and can be saved in a suitable 
source data set. 

3. If you write the work data set out to a tape, you no longer have access to the data sets 
previously existing on the tape. 

Option 5 — SUBMIT 

Option 5 (submit) injects a job (JCL and optional data) into the host job stream. The display 
and operation are similar to the READ and write commands. The data set name entered must 
be the fuUy-quaUf ied name of the host data set containing the JCL to be submitted. If you enter 
the keyword direct instead of a data set name, the contents of the work data set are 
transferred directly into the host job stream. The submit to host requires the Host 
Communications Facility on the System/ 3 70. 

Note: Use the direct keyword only in systems with a hasp or JES2 interface. 

Option 6 — PRINT 

Option 6 (print) prints the entire contents of the work data set on $sysprtr. (You can end the 
listing at any time by pressing the attention key and typing CA.) 






Option? — MERGE 



Option 7 (merge) merges all, or part, of a source data set into the current edit work data set. 
When you select MERGE, $FSEDIT displays the following screen indicating the name of the data 
set that is currently in the work data set (the target). 
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_ ^^ 

I -___ $FSEDIT - MERGE OPTION » 

"CURRENT" DATA SET: MYDS.MYVOL (CURRENTLY IN WORK DATA SET) 

MERGE DATA FROM: 
DATA SET NAME ===> 
VOLUME NAME =="> . 

FROM LINE # ====> (ENTER '*' IF ENTIRE- SOURCE DATA SET IS 
TO LINE #======> TO BE MERGED)'" ' 

ADD TO TARGET AFTER LINE # ===> . 



V. 



PRESS ENTER TO MERGE 
PRESS PF3 TO CANCEL 



^^\ 



Enter the name of the data set and volume you want merged with the information in the work 
data set. You may type in line numbers (leading zeros are not required) or enter an asterisk if 
you want to merge the entire data set with the work data set. In addition, you can specify the 
line number in the target data set where you want the merged data to start. If you do not 
specify a line number, the merged data is placed at the beginning of the target data set. 

The specification of an asterisk should only be used for the source data set. If all parameters are 
correct, the data is then read from the source data set, added to the current work data set, and 
the current work data set is renumbered. (If the format of the line number specification is 
incorrect, an error message is displayed and $fsedit prompts you for the data again.) 

To cancel the merge, press the PF3 key and return to the primary menu. 

Notes: 

1 . Once the merge has started, you must allow it to complete normally or you may get 
unpredictable results. 

2. If you want to merge a host data set with a native data set, the line numbers in the host data 
set may be incompatible. To correct this incompatibility, read the host data set into the 
work data set and write it back out to the disk. $FSEDIT automatically resets the host data 
set numbers to be in columns 73-80. 



Options — END 

Option 8 (end) ends the $fsedit utility. 
Options — HELP 

Option 9 (help) displays tutorial text for using $fsedit. 
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Primary Commands 

The following primary commands are used in edit and browse mode: 

CANCEL (CANC) Cancel session and return to previous screen. 

CAPS Display data in upper or lower case. 

CHANGE (C) Change character strings. 

CLEAR (CL) Clear work data set. 

COBOL Set COBOL line numbers. 

END (E) Return to previous screen. 

FIND (F) Find a character string. 

LOCATE (L) Find specified line number. 

MENU (M) Return to primary option menu. 

PS Print current screen on $sysprtr. 

RENUM (R) Renumber data set. 

RESET Clear line numbers. 

TABS Set tab stops. 

WRITE Write work data set to host/native. 

Primary commands are entered on line 2 of the display in the command input field. You can 
enter all primary commands while in edit mode. In browse mode, six primary commands are 
recognized by $fsedit: locate, find, menu, end, cancel, caps. 

You can enter most of the secondary commands in abbreviated format; for example, you can 
enter c instead of change. The abbreviation and full word command for each command, if 
appUcable, are shown. 

Each of the secondary commands is described on the following pages. 






\J 
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CANC (CANCEL) — Cancel Session and Return to Previous Screen 

The CANCEL command, when used in browse mode, returns you to the previous screen 
(primary option menu or directory data set list). 

The CANCEL command, when used in edit mode, terminates the edit without processing the 
screen and returns you to the previous screen (primary option menu or directory data set list). 

If you create a new data set, enter data, and then enter the CANCEL command, the utility does 
not save any of the data you entered since you last pressed the pf key or the enter key. 

If you are editing an existing data set and you add new data and then enter the cancel command, 
the utility saves the data as it was when you last pressed the PF or enter key. None of the new 
data you entered on the screen since the last pressed the PF key or enter key is saved, saved. 

Syntax: 




CAPS — Set Upper-Case Conversion 



C^ 



In BROWSE mode, the caps command specifies whether or not displayed data is to be converted 
to uppercase characters before being displayed on the screen. 

In EDIT mode, the CAPS command specifies whether or not entered data is to be converted to 
uppercase characters when edited. 

The CAPS command allows the entire work file to be converted to upper case. 

Note: If you enter caps without specifying ON or OFF, $fsedit displays whether CAPS 
are ON or OFF. When you read in a data set and all data is upper case, the CAPS ON 
condition is set. If lowercase data is detected, the caps condition is set to CAPS OFF. 

Syntax: 



CAPS ON/OFF ALL 

Required: none 
Defaults: none 
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Operands Description 

ON In BROWSE mode, all data is converted and displayed on the screen in upper case. 

In EDIT mode, data is displayed on the screen exactly as it appears in the work file; 
for example, upper case is mixed with lower case. 

If any edit data is entered and it changes the existing data, that entire line (or 
hnes) is changed to upper case in the work file and on the screen. The following 
is an example of upper and lower case being read using edit mode with caps on. 
The example has a misspelled word 'lowwercase'. If you correct the misspelling, 
the whole line is changed to upper case. 

In this example, the first sentence shows how the line was read in. 
I This is an example of upper and lowwercase. I 



L 



When you correct the misspelled word (lowwercase), the following occurs. 

THIS IS AN EXAMPLE OF UPPER AND LOWER CASE. 



OFF In BROWSE mode, all data is displayed with no conversion to upper case. 

In EDIT mode, data is displayed as it is with no conversion. The data is read from 
the terminal with no conversion. To enter uppercase data, you must press the 
shift key. 

Note: If $FSEDIT is being used on a terminal with only an uppercase character set, 
the lowercase character text data appears as blanks. If you press the enter key or 
any pf key, the lowercase data is lost in the work data set only. 

ALL When you enter CAPS ON ALL in EDIT mode, the entire work data set is converted 

to upper case and CAPS is set to ON. 

CAPS ON ALL has no meaning if you use it in BROWSE mode. If you use it, you will 
get a message. 



J?' 



U W 
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C (CHANGE) — Change Text (Edit Mode Only) 

The c command changes text strings. The search for the 'textl' string proceeds until the string 
is found or the bottom of the data set is reached. If found, 'textl' is replaced with 'text2'. If the 
two text strings are not the same length, automatic shifting is performed by expanding or 
collapsing blank characters at the end of the line. If insufficient blanks exist for shifting right 
without shifting a nonblank character into column 72, the change is not made and the line is 
displayed with an error message in the line number field. (If you selected the ALL option, the 
change is ended at this point.) If the 'textl' string is not found, you are notified with an error 
message displayed on the top Une of the screen. 

Use a combination of the repeat find key (PF4) and the repeat change key (pf5) to find and 
change selected occurrences of a specific character string. 

In CAPS OFF mode, the change command searches for the text string and when it finds it, it 
makes the change as entered. 

In CAPS ON mode, the change command converts the text string to upper case and then 
searches the work file. If the text is found, the change is made and the entire line on which the 
text appears is converted to upper case. 

Syntax: 



CHANGE /textl /text2/option 
C /textl /text2 /option 

Required: /textl /text2/ 
Defaults: option defaults to 'NEXT 



Operands Description 

/textl /text2/ The delimiter (/) can be any alphanumeric character except blank. It is not 
part of, and cannot appear in, the character strings 'textl' and 'text2'. All 
three delimiters are required and all must be the same character, 'textl' and 
'text2' can be any character string not containing the delimiter you used. 
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option 



Defines the beginning and the extent of the search. The following are valid 
options: 

NEXT 

Locate and change the next occurrence of 'textl' to 'text2'; the search starts 
with the first line displayed. This is the default. 

FIRST 

Locate and change the first occurrence of 'textl' beginning the search at the 
first line of data set. 






ALL 



Locate and change all occurrences of 'textl' beginning at the first line of the 
data set. 



CL (CLEAR) — Clear Work Data Set (Edit Mode Only) 

The CL command clears the work data set. 

Syntax: 



CLEAR 
CL 






Operands Description 
None 



o 
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COBOL — Set COBOL Line Numbers (Edit iVIode Only) 

The COBOL command sets line numbers in columns 1 to 6. 
Syntax: 



COBOL 
CO 

Required: None 
Defaults: None 



E (END) — Return to Previous Menu 



#^, 
^»i*»-^''' 



The E command ends edit or browse mode and returns to the previous screen (primary option 
menu or directory data set list). 

Syntax: 




Operands Description 
None 



Chapter 4. Utilities UT-3 3 9 



$FSEDIT 

$FSEDIT - Full Screen Editor (continued) 



F (FIND) — Find Text String 

The F command finds and displays text strings. The search proceeds until the text string is 
found or until the end of the data set is reached. If the string is found, automatic scrolling takes 
place to display the line containing the text string at the top of the data area of the display. If 
the string is not found, you are notified. 

Use the repeat find key (pf4) to find selected occurrences of a specific character string. 

In CAPS OFF mode, the find command searches for the text string as you entered it. 

In CAPS ON mode, the find command converts the text string to upper case and then searches 
the work data set. 

Syntax: 



FIND /text/ option 
F /text/ option 

Required: /text/ 

Defaults: option defaults to 'NEXT 



Operands Description 

/text/ The delimiter (/) can be any alphanumeric character except blank which does not 

appear within the text string. Both delimiters are required and must be the same 
character. 

option Defines the beginning of the search. The valid options are: 

NEXT 

The search starts with the first line of the current display. This is the default. 

FIRST 

The search starts at the first line of the data set. 



o 
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L (LOCATE) — Locate Line Number 



The L command locates and displays the requested line number. The data set is searched for the 
requested line. If found, automatic scrolling takes place and the requested line is displayed at 
the top of the display. If the requested line number is not found, $FSEDIT issues the following 
message: 



I 



LINE NUMBER NOT FOUND 



Syntax: 



LOCATE line-number 
L line-number 

Required: line-number 
Defaults: none 






Operands Description 

line-number The number of the line to be located and displayed. 

IVl (IVIENU) — Return to Primary Option Menu 

The M command ends edit or browse mode and returns to the primary option menu. 
Syntax: 



MENU 
M 



Operands Description 
None 
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PS — Print the Current Screen (Edit Mode Only) 

The PS command prints the currently displayed screen on the printer specified. If you do not 
specify a printer, the listing is directed to the $sysprtr. 

If the screen is printed, the message SCREEN printed appears in the upper right hand column of 
the screen. If the printer is busy, the message printer busy appears in the upper right hand 
column of the screen. 

Syntax: 



PS devname 

Required: none 
Defaults: $SYSPRTR 



Operands Description 

devname The name of the printer where you want the display printed. 

R (RENUM) — Renumber Data Set (Edit Mode Only) 

The R command assigns new hne numbers to each line of the data set. 
Syntax: 






RENUM first increment 
R first increment 

Required: none 

Defaults: first and increment default to 10 or to 
the values last used. 



Operands Description 

first The number to be assigned to the first line of the data set. 

increment The increment to be used in generating line numbers. 

Note: If the number of lines in the data set is so large that the maximum Une number of 32767 
is exceeded, the 'first' and 'increment' values are reduced automatically until the data set can be 
renumbered properly. 
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RESET — Reset Line Commands (Edit Mode Only) 

The RESET command is used to reset erroneous or unwanted line commands, to reset line 
numbers to normal after they were replaced with err messages, to terminate the display of 
MASK and column lines, and to clear change flags. $fsedit issues an err message in the line 
number column when you attempt to shift left or right and there is no room on the line to do so. 

Syntax: 



RESET 



TABS — Set Tab Stops (Edit Mode Only) 






The tabs command sets a maximum of ten tab stops at the locations specified. The default 
setting using a newly initialized data set is 'TABS 1,10,20,30,40,50,60,70'. If you modify any 
default setting, the system will not support any other default settings. In such an instance, each 
required setting must be requested specifically. If you set tabs that are out of sequence, such as 
20,30,10,40,60, $FSEDIT ignores the out of sequence tabs (in this case, 10). If you set more 
than 10 tabs, $fsedit only recognizes the first ten tabs. If you set a tab that is more than 72, 
the tabs will wrap around in the line number columns. 

Note: The tabs command is supported on a 4978 and 4980 display terminal. See the 
Operation Guide for a description of the tab key. 

Syntax: 



TABS loci, loc2 locIO 

Required: loci 

Defaults: 1,10,20,30,40,50,60,70 



Example: Set tabs stops in columns 1, 15, and 30. 

I TABS 1,15,30 
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WRITE — Save Contents of Work Data Set (Edit Mode Only) 

The WRITE command saves the contents of the work data set on disk, diskette, or tape under the 
specified data set and volume name. If no target data set and volume is specified, the contents 
are saved in the data set that was read into the work data set. If the data set name is given with 
no specified volume name, the contents are saved in the specified data set name on the volume 
you are accessing currently. 

Syntax: 



WRITE data set, volume 

Required: None 

Defaults: Same data set from where the contents of the work data 
set were originally obtained. 



Operands Description 

data set The name of the data set where you want to save the contents of the work data set. 

volume The volume where the data set resides. If you do not specify a volume name, 

$FSEDIT assumes the data set is on the volume you are using currently. 



\ >^ 



Edit Line Commands 



You can use the following edit line commands to delete, insert, dupUcate, or rearrange a single 
line or a group of lines. They are valid only in edit mode. 

) Shift hne two spaces to right. 

( Shift line two spaces to left. 

> Move a block of data two spaces to the right after the first blank. 

< Move a block of data two spaces to the left after the first blank. 

A Copy/move after. 

B Copy/move before. 

C,CC Copy line(s) of text. 

COLS Display columns. 



UT-344 SC34-0644 



$FSEDIT 



o 



$FSEDIT - Full Screen Editor (continued) 



D,DD Delete line(s) of text. 



I,II 



Insert line(s) of text. 






Shift Right ) 



Shift Left ( 



Move Right > 



Move Left < 



MASK Display insert mask. 

M,MM Move line(s) of text. 

Single character line commands operate on a single line of data and are specified by entering the 
line command in the first position of the line preceding the line number. 

Double character line commands operate on blocks of data and are specified by entering the 
block command in the first two positions on the first and last line of the block of data. 



Use the ) symbol to shift the Une two spaces to the right. 



Use the ( symbol to shift the line two spaces to the left. 



After the first blank, move a block of data two spaces to the right. A block of data is defined as 
a group of characters separated by no more than one blank. 



After the first blank, move a block of data two spaces to the left. A block of data is defined as a 
group of characters separated by no more than one blank. 



A (After) and B (Before) 



Use the A and b commands to define the destination for a copy or move operation. 'A' defines 
the destination as being after the line and 'B' defines the destination as being before the line. 
Thus it is possible to move or copy anywhere in the data set, including before the first line or 
after the last line. 



C (Copy Line) and CC (Copy Block) 



Use the c and CC command to duplicate Unes of data within the data set. The block of data 
defined by the two CC Une commands is copied to the location specified by an a or B line 
command. The copy operation leaves the original data intact and inserts a duplicate copy of the 
data at the destination specified. The copy occurs when you press the enter key after you define 
both the lines to be copied and the destination. The destination does not have to be on the same 
page of the display as the copy line command(s) and you can separate the two CC line 
commands also. 

In CAPS OFF mode, the line(s) are copied as they are. 
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In CAPS ON mode, the copied line(s) are converted to upper case and the original data remains 
the same. 

Example 1: Copy block. 



EDIT 



COMMAND 

■JU4, JL a. JL JL J 



EDITWORK, EDX002 

INPUT ===> 

"*" TOP OF DATA *' 
CCOOOIO LINE 1 
CC00020 LINE 2 
B""*"" *"** BOTTOM OF DATA 



2( Ik) — 



COLUMNS 001 072 
SCROLL ===>HALF 






Example 2: Screen image after block copy. 



EDIT -— EDITWORK, EDX002 

COMMAND INPUT ===> 

""""" *"""* TOP OF DATA "' 



00010 LINE 
00020 LINE 
00030 LINE 
00040 LINE 



V>. 



1 

2 
1 

2 
BOTTOM OF DATA 



k{ Ih) — 



DATA RENUMBERED 
SCROLL ===>HALF 



COLS — Display Columns 



Use the COLS command to display a line showing column numbers. To display the column 
numbers, type COLS starting in the left margin of the Une where the display is desired. 






Example 1 : COLS line command. 
/ 



EDIT --- EDITWORK, EDX002 

COMMAND INPUT ===> 

""*"* =•"""" TOP OF DATA "' 

0000010 LINE 1 

C0LS020 LINE 2 

0000030 LINE 3 

""""" ""*" BOTTOM OF DATA 



3( 1089)- 



COLUMNS 001 072 
SCROLL ===>HALF 



J 
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Example 2: Screen image after COLS line command. 



V 



EDIT — EDITWORK, EDX002 3( 1089)-"- COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===>HALF 

"*""* ***"" TOP OF DATA aaaaaaaaaaaaaaaaaaaaa^^cAaaaaaaaaa 

0000010 LINE 1 
0000020 LINE 2 

COLS + 1 + 2 + 3 + h + 5- 

0000030 LINE 3 

■ ■ ■ - --- BOTTOM OF DATA 



^^^^^^^^^^^ ^^^^^^^^^^ ^^^ ^ ^^^ 



D (Delete Line) and DD (Delete Block) 






Use the D and DD commands to delete a line or a block of data. A 'D' on a line causes the line 
to be deleted when you press the enter key. More than one line can be deleted by entering a D 
on each line. The DD line commands are used to delete a block of data. The DD is entered on 
the first and last line of the block of data to be deleted. The first line of the block does not have 
to be on the same display page as the end of the block (scrolling can take place between 
defining the two dd Unes). The block of data is deleted when you press the enter key the first 
time after you have specified both DD commands. 

Example 1 : Delete block of hnes. 



r 



EDIT - 


--- EDITWORK, 


EDX002 


COMMAND INPUT ===> 




>i. ^ Jj J- ^ 


TOP OF 


DATA " 


00010 


LINE 


1 




DD0020 


LINE 


2 




00030 


LINE 


3 




DDOO^O 


LINE 


k 




00050 


LINE 


5 




00060 


LINE 


6 




00070 


LINE 


7 





7( Ih)- 



COLUMNS 
SCROLL = 



001 072 

^==>HALF 






BOTTOM OF DATA 



Example 2: Screen image after block delete. 



r 



EDIT --- EDITWORK, EDX002 

COMMAND INPUT ===> 

""""" """"" TOP OF DATA "' 

00010 LINE 1 

00050 LINE 5 

00060 LINE 6 

00070 LINE 7 



k[ Ik)- 



COLUMNS 001-072 
SCROLL ===>HALF 



A 



^ 



BOTTOM OF DATA 
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I (Insert) — Insert New Line 

Use the i command to cause a new line to be inserted following the line where you enter the i 
command. Any information typed on the inserted line is assigned a line number and becomes 
part of your data when you press the enter key. If the line number assigned to the newly 
inserted line is equal to, or greater than, the line number of the next sequential Une, all data to 
the end of the data set is renumbered automatically. If you don't enter any information, the 
inserted line is deleted automatically the next time you press the enter key. 

If you enter information on the inserted line and the cursor is still on the inserted Une when you 
press the enter key (use PF7 on the 3101), another new Une is inserted automatically. This 
allows you to generate Une after Une in a continuous insert mode. The cursor is set to the first 
position where data appears in the following Une. 

The inserted line dupUcates the current value of the edit mask line. The initial value of the mask 
line is 72 blanks. You can change it at any time as noted in the description of the MASK 
command. 

Note: You can enter the I Une command on the top of data message line to insert a 
line ahead of what is currently the first Une. It is typed in the first position of the top of 
DATA line. 

In CAPS OFF mode, the data is inserted in the work file as entered. 

In CAPS ON mode, the data is converted to upper case before being inserted in the work file. 

Example 1 : Insert a line of text. 



EDIT --- EDITWORK, EDX002 

COMMAND INPUT ===> 

I"""" """" TOP OF DATA ""' 

00010 LINE 1 

00020 LINE 2 
""""" """" BOTTOM OF DATA 



2( 24) 



- COLUMNS 001 072 
SCROLL ===>HALF 



Example 2: Screen image after i Une command 



r 



EDIT --- EDITWORK, EDX002 

COMMAND INPUT ===> 

""*"" ***"" TOP OF DATA "'' 

00010 LINE 1 
00020 LINE 2 
""""" *""" BOTTOM OF DATA 



2( Ik)- 



COLUMNS 001 072 
SCROLL ===>HALF 
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II (Insert Block) — Insert Block of Lines 






Use the ll command to insert a block of new data. The Une with the II command is displayed at 
the top of the display with twenty-one inserted lines following it. You can enter data on all 
twenty-one Unes before you enter it with the enter key. The new data is then saved as with the i 
command. If all inserted lines have data entered on them and the cursor is left on the last line of 
the display when you press he enter key, another twenty-one lines are generated. If data is not 
entered on one or more of these Unes, the unchanged lines are deleted and the insert mode is 
ended. 

Notes: 

1 . The II command can be entered on the TOP OF data message Une to insert data in front of 
what is now the first Une. It is typed over the first two asterisks of the TOP OF data Une. 

2. The II command is different from the rest of the double character line commands. It is 
entered on only one Une and generates a block of twenty-one blank lines. 

3. The inserted Unes duplicate the current value of the edit Une mask. 
In CAPS OFF mode, the data is inserted in the work file as you enter it. 

In CAPS ON mode, the data is converted to upper case before being inserted in the work file. 
Example 1 : Block insert Une command. 



V 



EDIT -— EDITWORK, EDX002 
.COMMAND INPUT ===> 
""""" ""**" TOP OF DATA "' 
00010 LINE 1 
100020 LINE 2 
""""" """" BOTTOM OF DATA 



2( Ih) — 



COLUMNS 001 072 
SCROLL ===>HALF 



Example 2: Screen image after block insert command. 



EDIT --- EDITWORK, EDX002 
COMMAND INPUT ===> 
00020 LINE 2 



2( Ik) — - COLUMNS 001 072 
SCROLL ===>HALF 
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MASK — Display Insert Mask 



Use the MASK line command to display the insert mask which is used to prefill inserted lines. 
The insert mask is 72 bytes long and is initialized to all blanks the first time the work data set is 
used. The mask is stored in the header of the work data set. Any data filled into the mask 
remains in effect until you change it or you clear it by inserting blanks. The insert mask can be 
changed any time it is displayed by overtyping it with the desired information. 

To display the insert mask, enter all four characters of the mask Une command by overtyping 
the first four characters of the line number. For example: 



r 



EDIT --■ 
COMMAND 



MYDATA.EDXitO 
INPUT ===> 
""*"" TOP OF DATA'' 



15( 1089)- 



>i 



1 CHANGES 



COLUMNS 001 072 



^x^^ux^^xxxxxa.^x^x^59!:Li:iL!;!x!:^ 



00001 LINE 

MASK 10 LINE 

00020 LINE 

00030 LINE 



The current mask is displayed following the line where you entered the mask command. 



EDIT --- MYDATA, £0X^40 
COMMAND INPUT ===> 

"""""""""*"" TOP OF DATA 

00001 LINE 1 

00010 LINE 2 

MASK> 

00020 LINE 3 

00030 LINE ^ 



15( 1089) 



1 CHANGES 



COLUMNS 001 072 



SCROLL ===> HALF 



MH^^ 






You can replace the blank mask by overtyping it with the desired information. Once you enter 
the information, the mask remains in effect until you change it. Each time you enter an i to 
insert a line, the current mask is displayed on the insert line. In the following example, the mask 
has been set to the characters comment. 



MYDATA.EDX^O 



EDIT 

COMMAND INPUT ===> 

AAAAAAAAAAAA -j-qP OF DATA 

00001 LINE 1 
00010 LINE 2 

COMMENT 

00020 LINE 3 
00030 LINE 4 



15( 1089)-- 1 CHANGES 



Lj.a.jLa.x.i.a.a.j^juj^j 






COLUMNS 001 072 



^ 



J 



To remove the mask from the screen currently being displayed, enter the reset command on the 
COMMAND INPUT line. You cannot remove the mask using the CLEAR command. 



1^ 
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$FSEDIT - Full Screen Editor (continued) 



M (Move Line) and MM (Move Block) 



"\^ 



Use the M and mm commands to move a line or block of lines from one location to another. 
When you enter an M line command, a single line is moved to the location specified by an A or B 
line command. The MM line command causes the block of data defined by the two mm line 
commands to be moved to the location specified by an A or B line command. The moved lines 
are removed from their original location and the entire data set may be renumbered after the 
move. The move occurs when you press the enter key the first time after you define both the 
lines to be moved and the destination. The destination does not have to be on the same page of 
the display as the move line command(s) and you can separate the two mm Une commands also. 

In CAPS OFF mode, the data is moved and remains the same. 

In CAPS ON mode, the data is converted to upper case before being moved. 

Example 1 : Move block of lines. 



r 



EDIT -- 

COMMAND 
A"""" "*"" 
00010 LINE 
00020 LINE 
00030 LINE 
MM040 LINE 
00050 LINE 
MM060 LINE 
00070 LINE 



EDITWORK, EDX002 
INPUT ===> 
--- TOP OF DATA - 

1 

2 

3 

k 

5 

6 

7 

BOTTOM OF DATA 



7( Ik)- 



COLUMNS 001 072 
SCROLL ===>HALF 



Example 2: Screen image after block move. 



EDIT - 


--- EDITWORK, 


EDX002 


7(24)- 


DATA 


RENUMBERED 


COMMAND INPUT ===> 






SCROLL ===>HALF 


:S:*AAA 


""""A TOP OF 


DATA "'^ 


kkki-.ki:iii^kii 


AAAAAAAAAAAAAAAAAAAA 


00010 


LINE 


k 










00020 


LINE 


5 










00030 


LINE 


6 










000^0 


LINE 


1 










00050 


LINE 


2 










00060 


LINE 


3 








;•;:;;; v'.:o;;::'§'l5;;;'' 


00070 


LINE 


7 








■i5;'f:^:'''v;::'v:::::;^::::- 


""""" 


i-.i-.-k-k 


BOTTOM 


DF DATA 


i:kkkkki-.kki< 


AAAAAAAAAAAAAAAAAAAA 
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$GPIBUT1 Utility 



The $GPIBUT1 Utility enables you to control and transfer data to and from gpib devices 
interactively. You can use this utility as a diagnostic tool, also, to check out the application 
program interface and the attached devices. 



o 



Invoking $GPIBUT1 

You invoke $GPIBUT1 with the $L operator command or option 4.9 of the session manager. 



> $L SGPIBUTl 
LOADING GPIBUTl A5P ,00:'tO:27 : , LP= 9200, PART=1 

$GPIBUn - GPIB UTILITY 

COMMAND (?): 



J 



$GPIBUT1 Commands 



To display the $gpibut1 commands at your terminal, enter a question mark in response to the 
prompting message, COMMAND (?):. 

COMMAND(?): ? 

CH - DEFINE END CHARACTER 

CP - CHANGE GPIB PARTITION 

DD - DEFINE DEVICE 

EN - END THE PROGRAM 

GP - GPIB CONTROL 

LDCB - LIST DEVICE CONTROL BLOCK 

RE - READ DATA 

RS - RESET I/O ADAPTER 

ST - READ ERROR STATUS 

SU - SUSPEND PROGRAM 

WR - WRITE DATA 

'ATTN - PGP IB' TO POST 



Vs. 



'ATTN - GPRESUME' TO RESUME PROGRAM 
COMMAND(?): 






If a $GPIBUT1 command fails, use the attention Ust command pgpib to terminate the faihng 
operation. If you use pgpib, you must issue an rs command (or rset if gp subcommands are 
used) to reset the adapter. 
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$GPIBUT1 Utility (continued) 



CH — Define End Character 

Use the CH command to define or change the ending character that is added to output data. 



COMMAND(?): cH 

CHARACTER TO BE APPENDED TO OUTPUT DATA -- NOW IS NONE 

1 = CARRIAGE RETURN 

2 = LINE FEED 

3 = END OF TEXT 

4 = USER SPECIFIED HEX BYTE 

5 = NONE 

SELECT CODE: 3 

END CHARACTER IS NOW ETX 
COMMAND(?): 



CP -T- Change GPIB Partition 



Use the CP command to change the partition to which the GPIB adapter is connected. The 
partition is initially defined at system generation. 



r 



COMMAND(?): cP 2 

PARTITION CHANGED TO 2 

COMMAND(?): cp 

PARTITION NUMBER (NOW IS 2): 

PARTITION NUMBER NOT CHANGED 

COMMANDC?): 



^ 
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$GPIBUT1 Utility ^cont/Vii/ec/; 

\ w 



DD — Define Device 



Use the dd command to prompt for the name of the GPIB adapter. This name is specified in the 
TERMINAL configuration statement. The name specified is used for all enqueues of the adapter 
until you issue another dd command. 

COMMAND(?): DD 

NEW GPIB TERMINAL NAME = GP I B 

COMMAND(?): 



EN — End The Program 

Use the en command to end the $GPIBUT1 utility. 



I 



COMMAND(?): EN 



GP — GPIB Control 



Use the GP command to enter the GPIB bus command options that can be specified using the 
TERMCTRL instruction. These are described in the Language Reference. 

When you enter GP and follow it by a bus command, $gpibuti prompts for additional data, 
depending upon the specific command. For example, the CON (configure) command requires /^ \ 

both configuration and programming data. For the REN (remote enable) command, you must \_V 

include a list of GPIB device addresses. 

Where appropriate, $GPIBUT1 performs printext/readtext operations as part of the execution 
of a GP command, inserting delimiters as needed. In some cases, one delimiter is a user-defined 
end character. The end character can be defined by the ch command. ^ 
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$GPIBUT1 UtW'ity (continued) 



COMMAND(?): GP 

GPIB COMMAND(?): CON 

OPTION(SE,EOS,TO,EOI): TO 
OPTION(SE,EOS,TO,EOI): 

CONFIGURATION DATA: W% 
PROGRAMMING DATA (OR NONE) 
PROGRAMMING DATA (OR NONE) 
PROGRAMMING DATA (OR NONE) 

CONFIGURATION DATA: ?E5 
PROGRAMMING DATA (OR NONE): 
PROGRAMMING DATA (OR NONE): 

CONFIGURATION .DATA: 

GPIB COMMAND(?): READ 
OPTION(SE,EOS,TO,EOI ): SE 

WARNING - EOS OR EOl REQUIRED ... 
OPTION(SE,EOS,TO,EOI ): EOS (end of string character) 

WARNING - SE MAY BE NEEDED ... 
EOS BYTE (HEX): OD (X'OD') 

OPTION(SE,EOS,T0,EOI): 
TRANSLATE INPUT? Y 

HOW MANY CHARACTERS (MAX=DEFAULT=80) : (let default) 
VALUE DEFAULTED TO 80 



IN 
OE; 



NONE 



(timer override) 



(S/1 talks, plotter listens) 
( i n i t i al ize plotter ) 
(output plotter error) 



(plotter talks, S/1 listens) 
(no data) 



(suppress exceptions) 



(error code=0) 



^ 



COMMAND(?): 



LDCB — List Device Control Block 



Use the LDCB command to list the contents of the current GPIB device control block (dcb). The 
DCB describes the last GPIB operation performed. However, the information provided may 
require that you use the GPIB Adapter manual. The items listed include: 

• Address of the gpib terminal control block (ccb) 

• Address of the gpib device control block (dcb) 

• Status of the dcb control word, specifically: 

— Cycle-steal status key (that is, the address space of the data buffer) 

— gpib operation mnemonic (for an undefined operation, '****') 

— Status of the chaining, input, suppress exception (se), end of string (EOS), timer override 
(to), and end of identify (eoi) bits, if they are set 
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$GPIBUT1 UtiWty (continued) 



End of string character 

Address of the residual status block (rsb) 

Chain address 

Byte count for the data transfer 

Address of the data buffer 

Contents of the data buffer, expressed as: 

— A string of hexadecimal words 

— EBCDIC characters 

— ASCII characters. 

The DCB is checked for certain error conditions, including: 

• DCB words two or three not equal to zero 

• RSB address not equal to zero, and suppress exception set 

• Chain address nonzero and chaining bit set. /" 

V 

If the byte count is odd, the last byte in the string of hex words is not part of the buffer and 
should be disregarded. Because the buffer data can be either EBCDIC or ASCII, depending on the 
application, it is displayed in both character codes. In most cases, the ASCII data that is 
displayed will be accurate. An inappropriate translation is displayed as a blank line. 
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$GPIBUT1 [JtiWtY (cont/nued) 






The following example illustrates a dcb used in the execution of: 



TERMCTRL GPIB,CON,TO 
PRINTEXT '?U%":@' 



r 



COMMAND (?): LDCB 

DISPLAY OF DCB FOR GPIB TERMINAL GP I B 

GPIB CCB AT ADDRESS 1058 
GPIB DCB AT ADDRESS OFFE 

CONTROL WORD 

CYCLE STEAL KEY ISO 
TIMER OVERRIDE SET 
DEVICE OPERATION IS CON 

BYTE COUNT IS 5 
DATA ADDRESS IS 1102 

DATA IN HEX FORMAT IS: 

3F55 2522 2C00 

DATA INTERPRETED AS EBCDIC IS: 

?U?": 

COMMAND (?): 



RE — Read Data 



Use the RE command to read data from the GPIB adapter. You can also specify GPIB options 
(TERMCTRL functions), translation, and the number of characters to be read. 



COMMAND(?): READ 

OPTION(SE,EOS,TO,EOI ): SE (suppress exceptions) 

WARNING - EOS OR EOl REQUIRED ... 
OPTION(SE,EOS,TO,EOI ): EOS (end of string character) 

WARNING - SE MAY BE NEEDED . .. 
EOS BYTE (HEX): OD (X'OD') 

OPTION(SE,EOS,TO,EOI ): 
TRANSLATE INPUT? Y 



HOW MANY CHARACTERS (MAX=DEFAULT=80) : 
VALUE DEFAULTED TO 80 



( let default) 
(error code=0) 



^ 



C0MMAND(?): 
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$GPIBUT1 Utility (continued) 



RS — Reset I/O Adapter 



Use the RS command to issue a device reset to the adapter. Any pending interrupt or busy 
condition is cleared when this command is executed. 

COMMANDC?): RS 

RESET ADAPTER? Y 
COMMAND(?): 



ST — Read Error Status 



Use the ST command to display the status information contained in the adapter cycle steal status 
words and the residual status block (rsb). 



r 



COMMAND(?): ST 



READ STATUS? Y 

CYCLE STEAL STATUS BLOCK (HEX) 

RESIDUAL ADDRESS = 

RESIDUAL BYTE COUNT = 

(RESERVED) = 

(RESERVED) = 

ERROR STATUS - 

BUS STATUS (AFTER POWER ON) = 

BUS STATUS (CURRENT) = 

SPE DEVICE ADDRESS = 

DCB SPECIFICATION CHECK = 

(RESERVED) = 

DCB ADDRESS = 

RESIDUAL STATUS BLOCK (HEX) 

RESIDUAL BYTE COUNT = 0000 



BifSA 
0050 
0000 
0000 
8000 
0008 
OOOA 
0000 
0000 
0000 
1238 









^ 



RSB FLAGS = 
(RESERVED) = 
(RESERVED) = 
(RESE"^VED) = 

RESET ADAPTER? Y 

NO DATA RECEIVED 

COMMAND(?): 



0000 
0000 
0000 

0000 (error status indicates time-out 
waiting to receive data) 



\J 
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$GPIBUT1 UtW'ity (continued) 



SU — Suspend $GPIBUT1 



Use the SU command to suspend the operation of $GPIBUT1 until you tell it to resume using 
GPRESUME. This enables you to run $gpibuti concurrently with a gpib application from the 
same terminal. 

COMMAND(?): SU 
$GPIBUT1 SUSPENDED 



WR — Write Data 






Use the WR command to write data to the GPIB adapter. You can specify GPIB options 
(termctrl functions) and translation. 



r 



COMMAND(?): WR 
OPTION(SE,EOS,TO,EOI ): 

WRITE HEX DATA? N 

ENTER TEXT: IN; 

IS THE DATA OK? Y 
COMMAND(?): WR 
OPTION(SE,EOS,TO,EOI ): 

WRITE HEX DATA? Y 

ENTER HEX WORDS: OAOD 0102 

IS THE DATA OK? Y 
COMMAND(?): 



(character data) 



(hex data) 
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$GPIBUT1 UtWlty (continued) 



PGPIB — Post GPIB Operation Completion 



Sometimes a GPIB operation waits indefinitely, such as when a device fails to respond to an 
operation in which timer override (TO) is specified. Use the PGPIB attention command to 
complete the operation; it cancels the operation by simulating its completion. However, after a 
PGPIB, the GPIB adapter is still in a busy state, so you must reset it. 



GPIB COMMAND ( 7) : READ 

OPTION {SE,EOS,TO,EOI ): TO 

TRANSLATE INPUT? Y 

HOW MANY CHARACTERS {MAX=DEFAULT=80) : 



A 



^ 



VALUE DEFAULTED TO 80 
> PGPIB 

DATA RECEIVED: 
GPIB COMMAND (?): RSET 
RESET ADAPTER? Y 



(user presses attention key) 



GPRESUME — Resume $GPIBUT1 Operation 



If you suspended $gpibuti using the su command, use the GPRESUME attention command to 
resume it. 

(press attention key) 
> GPRESUME 
$GPIBUT1 RESUMED 
COMMAND (?): 

^^ 






$GPIBUT1 Example 



The following example shows many of the $gpibuti utility operations. The attached device is a 
plotter. 



c # 
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$GPIBUT1 UtlVity (continued) 






> $CP 2 

> $L SGPIBUTl 
LOADING $GPIBUT1 



(Press attention key) 

(run in part i t ion 2) 
itSP.OOiitOiZ?, LP= 0000, PART=2 
$GPIBUT1 - GPIB UTILITY 
USING GPIB TERMINAL GPIB1 
COMMAND(?): DD 
NEW GPIB TERMINAL NAME = GPIB3 (invalid GPIB name) 

GPIB3 IS NOT A GPIB TERMINAL 
RETRY? Y 
NEW GPIB TERMINAL NAME = GP I B 

(so that SRQs will be received) 



COMMAND (?): CP 2 

PARTITION CHANGED TO 2 



COMMAND (?): CH 

CHARACTER TO BE APPENDED TO OUTPUT DATA 

1 = CARRIAGE RETURN 

2 = LINE FEED 

3 = END OF TEXT 

if = USER SPECIFIED HEX BYTE 
5 = NONE 

SELECT CODE: 3 

END CHARACTER NOW IS ETX 



NOW IS NONE 



Figure 20 (Part 1 of 5). $GPIBUT1 example 
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$GPIBUT1 Utility (continued) 






COMMAND (?): CH 

CHARACTER TO BE APPENDED TO OUTPUT DATA 

1 = CARRIAGE RETURN 

2 = LINE FEED 

3 = END OF TEXT 

k = USER SPECIFIED HEX BYTE 
5 = NONE 

SELECT CODE: 5 

END CHARACTER NOW IS NONE 
COMMAND (?): GP 



NOW IS ETX 



IN; 
OE: 



NONE 



GPIB COMMAND (?): CON 
OPTION(SE,EOS,TO,EOI): TO 
OPTION(SE,EOS,TO,EOl): 

CONFIGURATION DATA: ?U% 

PROGRAMMING DATA (OR NONE) 

PROGRAMMING DATA (OR NONE) 

PROGRAMMING DATA (OR NONE) 

CONFIGURATION DATA: ?E5 
PROGRAMMING DATA (OR NONE) 
PROGRAMMING DATA (OR NONE) 

CONFIGURATION DATA: 



GPIB COMMAND (?): READ 
OPTION(SE,EOS,TO,EOI): SE 

WARN I NG 
OPTION(SE,EOS,TO,EOI): EOS 

WARNING 
EOS BYTE (HEX): OD 
OPTION(SE,EOS,TO,EOI): 
TRANSLATE INPUT? Y 



(timer override) 



(S/1 talks, plotter listens) 
( ini t ial i ze p letter) 
(output plotter error) 



(plotter talks, S/1 listens) 
(no data) 



(suppress exceptions) 
EOS OR EOl REQUIRED ... 

(end of string character) 
SE MAY BE NEEDED ... 

(X'OD') 



^- 



/if ~^\ 



HOW MANY CHARACTERS (MAX=DEFAULT=80) 
VALUE DEFAULTED TO 80 



( let default) 
(error code=0) 



Figure 20 (Part 2 of 5). $GPIBUT1 example 






UT-362 SC34-0644 



$GPIBUT1 



o 



$GPIBUT1 UtW'ity (continued) 



^\ 



GPIB COMMAND(?): CON 

OPTION(SE,EOS,TO,EOl): 

CONFIGURATION DATA: ?U% 

PROGRAMMING DATA (OR NONE) 

PROGRAMMING DATA (OR NONE) 

PROGRAMMING DATA (OR NONE) 



IN; 

IM223,32,0; 

XX; 



«=^"""" SRa RECEIVED ""-««« 

PROGRAMMING DATA (OR NONE): 

CONFIGURATION DATA: 
GPIB COMMAND (?): SPE 

OPTION(SE,EOS,TO,EOI): 

TALKER ADDRESS LIST: E 
IS THE DATA OK? Y 

GPIB COMMAND (?): SPL 

WARNING - SPE MUST HAVE JUST BEEN EXECUTED 

TRANSLATE INPUT? N 

DATA RECEIVED: 
^578 

WARNING - AN SPD MAY NOW BE REQUIRED 

GPIB COMMAND (?): SPD 
OPTION(SE,EOS,TO,EOI ): 

GPIB COMMAND (?): READ 
OPTION(SE,EOS,TO,EOI): TO 

TRANSLATE INPUT? Y 

HOW MANY CHARACTERS (MAX=DEFAULT=80) : 



( in i t ial ize plotter ) 
(interrupt on error) 
( i nva 1 id command) 

(SRQ interrupt) 



(serial poll enable) 

(plotter talk address) 
(read ser ial pol 1 ) 
(no translation) 
(plotter address, status) 

(ser ial pol 1 d i sab le) 

(timer override) 
( trans late) 



VALUE DEFAULTED TO 80 



(read is in indefinite wait) 



Figure 20 (Part 3 of 5). $GPIBUT1 example 
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$GPIBUT1 Utility ^co/}t//M/e</; 



(Press attention key) 
> PGP I B 

DATA RECEIVED: 



(post GPIB completion) 
(no data received) 



GPIB COMMAND (?): READ 

OPTION(SE,EOS,TO,E01): 
TRANSLATE INPUT? Y 

HOW MANY CHARACTERS (MAX=DEFAULT=80) 
VALUE DEFAULTED TO 80 



ERROR CODE = 0002 

GPIB BUSY 

READ STATUS? N 

RESET ADAPTER? Y 

NO DATA RECEIVED 

GPIB COMMAND (?): READ 

0PTION(SE,E0S,T0,EOI): 
TRANSLATE INPUT? Y 



HOW MANY CHARACTERS (MAX=DEFAULT=80) 
VALUE DEFAULTED TO 80 

ERROR CODE = Ol80 

EXCEPTION ON INPUT 

DEVICE DEPENDENT STATUS AVAILABLE 

READ STATUS? Y 



(GPIB adapter is busy) 






Figure 20 (Part 4 of 5). $GPIBUT1 example 
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$GPIBUT1 Utility rco/it/#7t/e^; 



^ 



CYCLE STEAL STATUS BLOCK (HEX) 

RESIDUAL ADDRESS = B45A 

RESIDUAL BYTE COUNT = 0050 

(RESERVED) = 0000 

(RESERVED) = 0000 

ERROR STATUS = 8000 
BUS STATUS (AFTER POWER ON) = 0008 

BUS STATUS (CURRENT) = OOOA 

SPE DEVICE ADDRESS = 0000 

DCB SPECIFICATION CHECK = 0000 

(RESERVED) = 0000 

DCB ADDRESS = 1238 
RESIDUAL STATUS BLOCK (HEX) 



RESIDUAL BYTE COUNT = 
RSB FLAGS = 
(RESERVED) = 
(RESERVED) = 
(RESERVED) = 

RESET ADAPTER? Y 

NO DATA RECEIVED 

GPIB COMMAND (?): END 



0000 
0000 
0000 
0000 
0000 



(error status indicates time-out 
waiting to receive data) 



Figure 20 (Part 5 of 5). $GPIBUT1 example 
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$HCFUT1 - Interact with Host Communications Facility 

$HCFUT1 is a utility tliat uses the Host Communications Facility on the Series/ 1 to interact with 
the Host Communications FaciUty Installed User Program on the System/370. $hcfuti can 
perform four functions: 

• Read a data set from the host (readdata, readso, readobj). 

• Write a data set to the host (write). 

• Submit a job to the host (submit). 

• Status - Set, fetch, and release records in the system status data set. 

Invoking $HCFUT1 

You invoke $hcfuti with the $L operator command or option 8.8 of the session manager. 

$HCFUT1 Commands 

To display the $hcfuti commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



r 



COMMAND (?): ? 

END - END 

FETCH - FETCH STATUS 

RELEASE - RELEASE STATUS 

READDATA - READ HOST 

READ80 - READ 80-BYTE RECORDS - STORE 2/DISK RECORD 

READOBJ - READ 80-BYTE RECORDS - STORE 3/DISK RECORD 

SET - SET STATUS 

SUBMIT - SUBMIT A JOB 

WRITE - WRITE TO HOST 

COMMAND (?): 



After $HCFUT1 displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, su). 

Notes: 

1 . See 'Host Data Set Naming Conventions' and 'Host Data Set Characteristics' in 
Communications Guide. 

2. See 'System Status Data Set' in Communications Guide. Appendix B of the IBM Series/ 1 
Host Communications Facility Program Description and Operation Manual, SH20-1819, 
contains more details on its use. 



\. 



o 

^W*!"^ 
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$HCFUT1 - Interact with Host Communications Facility (continued) 

3. The Host Communications Facility lUP, program number 5796-PGH, is required on the host 
System/370. 

4. Host Communications Facility must be installed and configured on the Series/ 1 . 

READDATA — Transfer data set from host to Series/1 

READDATA transfers a data set from the host to the Series/ 1. The host logical record size is 
assumed to be 256 bytes. 

Three items of control information you must specify at execution time are: 

DSl The IS character name of the Series/ 1 data set to which data is to be 

transferred, and its volume name, if not the ipl volume. 

Record Count The number of records to be transferred, beginning with the first. This would 
be used if, for example, only the first 10 records of a 50-record data set are to 
be transferred. 

A count of zero is used to indicate that the entire data set is to be transferred. 

DSNAME The name of the host data set to be transferred. 

The following is a terminal printout of a typical run. In this example, all records (length = 256 
bytes each) of the host data set 'si.edx.testin(DATA)' (which contains 40 records) are 
transferred to the Series/ 1 data set 'datafil2'. 

r- ... 

> $L $HCFUT1 

LOADING $HCFUT1 8P,08.15.30, LP=itBO0 
WORKF I LE ( NAME .VOLUME ) : DATAF I L2 ,EDXOO 1 

COMMAND (?): READDATA 
NO. OF RECORDS TO READ(0=ALL): 
DSNAME: SI .EDX.TEST I N(DATA) 
END AFTER 40 RECORDS 

COMMAND {?): 

READ80 and READOBJ — Transfer Records from Host to Series/1 

READ80 and READOBJ transfer 80-byte records from a host data set and store them in 256-byte 
Series/ 1 disk or diskette data set records. 

READ80 stores two 80-byte records per 256-byte disk record. The first 80-byte record is stored 
in the first 80 bytes of the disk record. The second 80-byte record is stored starting at byte 129 
of the disk record. This format is compatible with the saved results of using $editin or $fsedit 
and is also the format required for input to a language compiler or $edxasm program 
preparation, readsg is normally used to transfer source program modules from the System/370 
to Series/ 1 disk. 
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$HCFUT1 - Interact with Host Communications Facility (continued) 

READOBJ Stores three 80-byte records in the first 240 bytes of each disk record. This format is 
compatible with object modules produced by any of the assembler programs. It is also the 
format required for input to $edxlink and is one of the formats accepted by $update. readobj 
is normally used to transfer the output object module of a host assembly to the Series/ 1 for 
processing by $edxlink or $update. 

You invoke both READ80 and READOBJ in a manner similar to READDATA. 
Status Commands (SE, FE and RED 

The status commands are used to perform, from a terminal, the SET, FETCH, and RELEASE 
functions on the system status data set. See Messages and Codes for status return codes. 

The following is an example of the use of the SET function of $HCFUT1. Status return code 700 
indicates that the index, key, and status records have been added. 



COMMAND {?): SE 
INDEX = TESTSET 
KEY = NEWRECD 
STATUS = 700 
COMMAND (?): 



The following is an example of the use of the fetch and release functions. The FETCH return 
code of 802 indicates that that particular key does not exist. The release return code of 900 
indicates a successful release. 



COMMAND (?): FE 
INDEX = TESTSET 
KEY = MISSINGl 
STATUS = 802 

COMMAND (?): REL 
INDEX = TESTSET 
KEY = MISSING! 
STATUS = 900 

COMMAND (?): 






J 



SUBMIT (SU) — Submit Job to Host Job Stream 



SUBMIT causes a job to be submitted to the host job stream. See Communications Guide for 
information about the requirements for host data sets. 

The name of the host data set containing the job control language to be submitted is specified 
on the Series/ 1 terminal. The following is a sample of the terminal printout illustrating the use 
of SU to submit the data set 'sledx.testsub.cntl'. 
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$HCFUT1 - Interact with Host Communications Facility (continued) 



COMMAND (?): SU 

DSNAME: SI .EDX.TESTSUB .CNTL 

JOB SUBMITTED 

ANOTHER JOB? n 

COMMAND (?): 



WRITE (WR) — Transfer Data Set from Series/1 to Host 

WR transfers a data set from the Series/ 1 to the host processor. The host logical record size is 
assumed to be 256 bytes. 

Three items of control information you must specify at execution time are: 



DSl 



The 1-8 character name of the Series/ 1 data set to be transferred, and its 
volume name, if not the ipl volume. 



Record Count The number of records to be transferred, beginning with the first. This would 
be used if, for example, only the first 10 records of a 50-record data set are to 
be transferred. 

A count of zero is used to indicate that the entire data set is to be transferred. 



DSNAME The name of the host data set to which the data is to be transferred. The 

name consists of up to 44 characters, or 54 characters for a member of a 
partitioned data set. 



The following is a terminal printout of a typical run. In this example, 28 records of the Series/ 1 
data set 'datafili' are transferred to the host data set 'si.edx.testout.data'. 



r 



> $L $HCFUT1 

DSl (NAME, VOLUME) 

LOADING $HCFUT1 



DATAFILI 

8P, 08. 15.20, LP=4B00, PART=2 



COMMAND (?): WR 

NO. OF RECORDS TO WR I TE(0=ALL) : 28 

DSNAME: SI . EDX.TESTOUT.DATA 

END AFTER 28 

COMMAND {?): 
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$HCFUT1 - Interact with Host Communications Facility (continued) 



Return Codes 



Program execution will be halted until the operation is complete, and the first word of the TCB 
(taskname) must be tested to determine if the operation was successful. The return codes are 
shown in Messages and Codes. 

Note: If an error is detected, an open data set is automatically closed for you. 
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$HXUT1 - H-Exchange Utility 



C\ 



$HXUT1 allows you to perform different functions for H-exchange data sets and volumes. You 
can transfer data contained on $HXUT1 diskettes from one system to another providing the target 
system can read diskettes formatted for Standards for Information Interchange. 

Volume-oriented functions consist of the following: 

CV - Change to another H-exchange volume. 

IV - Initialize volume. 

LA - List contents of H-exchange volume. 

LI - Redirect listings to another terminal. 

LS - List space in H-exchange volume. 

RE - Rename an H-exchange volume. 

UV - Update H-exchange volume label. 
Data-set-oriented functions consist of the following commands: 

AL - Allocate data set. 

DE - Delete data set. 

UD - Update H-exchange data set label by name. 

UH - Update H-exchange data set label by number. 
You can copy data between H-exchange and EDX data sets with the following commands: 

RX - Read H-exchange data set into EDX data set. 

WX - Write H-exchange data set from EDX data set. 

Note: For information on copying basic exchange diskettes see "$COPY - Copy Data Set" on 
page UT-72. 
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$HXUT1 - H-Exchange Utility (continued) 



Invoking $HXUT1 



\J 



You invoke the H-exchange utility with the $L operator command or option 3.11 of the session 
manager. Once invoked, $hxuti prompts you for the name of a diskette 2D volume in order to 
start the program. 

> $L SHXUTl 

LOADING $HXUT1 72P ,09: l8:62 , LP=2300, PART=1 

$HXUT1 - H EXCHANGE UTILITY 

VOLUME NAME = 



If the volume name you enter is not an H-exchange diskette, $hxuti asks if you wish to retry. 
TRY AGAIN (Y/N) . 



I 



Respond Y and $hxuti again prompts you for the name of the volume. 



I 



VOLUME NAME = 



If you want to exit the program, press the enter key in response to volume name=, and enter N 
in response to the TRY again (y/N)? prompt. 

VOLUME NAME = 

TRY AGAIN (Y/N)? N 

SHXUTl ENDED AT 09:18:23 






^kii-a'^ 
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$HXUT1 - H-Exchange Utility (continued) 



$HXUT1 Commands 



/^. 



To display the $HXUT1 commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 

f " " "" 

COMMAND (?): ? 

AL - ALLOCATE DATA SET 

CV - CHANGE VOLUME 

DE - DELETE DATA SET 

IV - INITIALIZE VOLUME 

LA - LIST ALL DATA SETS 

LI - CHANGE LISTING DEVICE 

LS - LIST AVAILABLE SPACE 

RE - RENAME VOLUME 

RX - READ H-EXCHANGE DATA^^-SET INTO EDX DATA SET 

UD - UPDATE DATA SET LABEL BY NAME 

UH - UPDATE DATA SET LABEL BY NUMBER 

UV - UPDATE VOLUME LABEL 

WX - WRITE H-EXCHANGE DATA SET FROM EDX DATA SET 

EN - END PROGRAM 

COMMAND {?): 



After $HXUT1 displays the commands, you are prompted again with COMMAND (?):. Then you 
can respond with the command of your choice (for example, al). 



Using the H-exchange utility 



Commands that require parameter information prompt you for the parameters. Advance input 
is acceptable, except where data is being destroyed. In those commands which alter a value, the 
current value is displayed prior to the entry of the new value. Do not enter a new value if the 
current value is to be saved; just press the enter key. 

You can direct certain listings produced by this utility to another terminal or printer. You can 
do this with the Li command. The Li command enables you to list the volume contents, volume, 
or data set labels. 



Data Set Copying Considerations 



The copy commands support partial copies. You can select a portion of the data set to be 
copied by specifying the starting and ending record numbers. These record numbers are relative 
to the overall data set. In the case of a multivolume copy, the numbers are relative to all 
preceding segments of the data set, not the current segment. Segments are the portions of 
multivolume data sets that span diskettes. If one data set is copied completely to another, the 
end of data set pointer is set to reflect the last record copied. Once a data set on a multivolume 
data set is allocated, the continued/lst indicators are not modified on subsequent use of the data 
set. 



Chapter 4. Utilities UT-373 



$HXUT1 

$HXUT1 - H-Exchange Utility (continued) 



Naming Conventions 






$HXUT1 supports a naming convention for volumes containing segments of a data set. If the 
volume name for the current segment of a data set is XXXXnn (where nn is "01" through 
"98"), then the copy command searches for a volume name of the form XXXXmm, where 
mm=nn+ 1. For example, if the volume name for the current segment of a data set is fileoi, 
the copy command searches for a volume name of file02. 



AL — Allocate H-Exchange Data Set 



Use the al command to allocate a single volume H-exchange data set. You must enter the name 
and size of the data set. 



^ 



COMMAND (?): AL 

DATA SET NAME: CUSTFILE 

NUMBER OF RECORDS: 100 

CUSTFILE ALLOCATED, SIZE IS 100 RECORDS 



\.: 



V 
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$HXUT1 - H-Exchange Utility (continued) 






When there is insufficient space in the volume to allocate the data set, $hxuti informs you. 
You then can allocate the data set at the size of the largest remaining free space in the volume. 

■ ^-> 

COMMAND {?): AL 

DATA SET NAME: CUSTFILE 

NUMBER OF RECORDS: 2000 

INSUFFICIENT SPACE TO ALLOCATE DATA SET 

THE LARGEST EXTENT AVAILABLE CONTAINS 1500 RECORDS 

ALLOCATE DATA SET FOR THIS SIZE (Y/N)? Y 

CUSTFILE ALLOCATED, SIZE IS 1500 RECORDS 

To allocate a data set which already exists, the following rules apply to the existing data set. If 
the existing data set is: 

• Write protected - the command is terminated. 

• Larger than or equal to your request - it is used to satisfy your request. 

• Too small to satisfy your request - you are asked if the data set should be saved. 



CUSTFILE ALREADY EXISTS, SIZE IS 100 RECORDS 
SAVE IT? (Y/N) 



Note: If the data set is saved, the command is terminated. If the data set should not be saved, it 
is deleted, and the new data set is allocated elsewhere in the volume. 
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$HXUT1 - H-Exchange Utility (continued) 

CV — Change to Another H-Exchange Volume 

Use the cv command to change the H-exchange volume. (This affects all commands except for 
the copy commands.) 



COMMAND {?): CV 

VOLUME NAME (NOW IS 'ENTIEV') = VOLCAN 



DE — Delete Data Set 



Use the DE command to delete a H-exchange data set, if it is not write protected. You must 
enter the name of the data set. 



COMMAND (?): [ 
DATASET NAME: 


)E 

ACC 
Y/N) 


rREC 
? Y 








^ 


ARE YOU SURE 
ACCTREC DELE 


( 
TE 












COMMAND (?): 
















J 



IV — Initialize Volume 



Use the iv command to initialize a diskette 2D for processing as a H-exchange volume. The 
diskette must have been formatted by $DASDi to be compatible with interchange standards and 
at 256 bytes per sector. 



o 



COMMAND (?): IV 



'" WARNING 



INITIALIZATION WILL DELETE ALL EXISTING DATA SETS 
CONTINUE (Y/N)? Y 

INITIALIZATION COMPLETE 

COMMAND (?): 



o 
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$HXUT1 - H-Exchange Utility (continued) 



LA — List Contents of H-Exchange Volume 

Use the LA command to list the contents of an H-exchange volume. The list operation Usts the 
names of the data sets contained on an H exchange diskette. The location and size are also 
listed, both in edx and CCHSS format. The listing also indicates if the data set is continued on 
another volume or is the last in a sequence. In both cases, the sequence number is displayed. 

If listings are being redirected to another terminal, a list space command is executed 
automatically. 



COMMAND (?): LA 

VOLUME NAME = VOLCAN 
OWNER ID = J SMITH 
SYSTEM CODE = IBMEDXS1 

DATA SET NAME TYPE START 



ACCTPAY 
ACCTREC 
CUSTFILE 
BILLING 



53 

163 

1663 

138 



SIZE BOE EOE 

10 01001 01010 
1500 03007 3II2A LAST (02) 

100 31125 33120 

23 02108 0300^+ CONTINUED (01) 









The listing can be cancelled by the attention command CA. 

LI — Redirect Listings to Another Terminal 

Use the LI command to direct listings to another terminal. If the terminal from which you 
loaded $HXUT1 is to be specified, do not enter data. 



COMMAND (?): LI 



V 



LISTING TERMINAL: TERM03 
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$HXUT1 - H-Exchange Utility (continued) 

LS — List Space in H-Exchange Volume 

Use the LS command to list the space available for data set definitions and data in the current 
volume. 






COMMAND (?): LS 

THE NUMBER OF DEFINED DATA SETS IS k 

THE NUMBER OF UNUSED DATA SET ENTRIES IS 67 

THE LARGEST EXTENT AVAILABLE CONTAINS 2138 RECORDS 

DISPLAY THE LIST OF AVAILABLE SPACE {Y/N)7 Y 

FIRST REC SIZE 



63 75 

161 2 

1763 2138 



RE — Rename an H-Exchange Volume 

Use the RE command to rename an H-exchange volume. 

COMMAND (?): RE 

VOLUME NAME (NOW IS 'ABC'): DEF 
RENAME COMPLETED 






i J 
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$HXUT1 - H-Exchange Utility (continued) 

RX — Read an H-Exchange Data Set into an EDX Data Set 

Use the RX command to copy an H-exchange data set to an EDX data set. If the EDX target data 
set already exists, it is not reallocated. If the target edx data set does not exist, it is 
automatically allocated. If the H-exchange data set resides on a single diskette, the target size is 
that of the H-exchange data set. Otherwise, you are asked for the number of diskettes that the 
multivolume data set spans. For each diskette, 3848 records are allocated in the target data set. 
If the entire data set is copied, the edx data set end of data is set to a value corresponding to the 
H-exchange end of data. 

Note: You must enter the H-exchange volume name. There is no default value defined. 

Example 1 : Copy an entire single volume H-exchange data set to an EDX data set. 



J 



COMMAND {?): RX 

SOURCE EXCHANGE DATA SET (NAME, VOLUME) 
COPY ENTIRE DATA SET? (Y/N): Y 

TARGET EDX DATA SET (NAME, VOLUME): 

CUSTFILE ALLOCATED SIZE IS 52 RECORDS 



CUSTFILE,CANTST 
CUSTFILE, EDX003 



COPY OF CUSTFILE, CANTST TO CUSTF I LE ,EDX003 COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS 52 



Example 2: Copy part of a single volume H-exchange data set to an edx data set. 



r 



COMMAND (?): RX 

SOURCE EXCHANGE DATA SET (NAME, VOLUME): CUSTF I LE , CANTST 

COPY ENTIRE DATA SET? (Y/N): N 

STARTING RECORD NUMBER: 5 

COPY TO END OF DATA SET? (Y/N): Y 

TARGET EDX DATA SET (NAME, VOLUME): TEST, CAN 
STARTING RECORD NUMBER: 1 

TEST ALLOCATED, SIZE IS 20 RECORDS 

COPY OF CUSTFILE, CANTST TO TEST, CAN COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS 20 
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$HXUT1 - H-Exchange Utility {continued) 



Example 3: Copy an entire multivolume data set to an edx data set. This example prompts 
for the volmne name because the H-exchange "Naming Conventions" on page UT-374 were not 
used. 



COHHAND (?): RX 

SOURCE EXCHANGE DATA SET (NAME, VOLUME): SEDXL.CANTST 
COPY ENTIRE DATA SET? (Y/N): Y 

TARGET EDX DATA SET (NAME, VOLUME): SEDXL.CAN 

HOW MANY DISKETTES (1-99): 2 

$EDXL ALLOCATED, SIZE IS 7696 RECORDS 

THIS ISA MULTIVOLUME COPY 

SOURCE MAY NOT FIT INTO TARGET 

PLEASE MOUNT DISKETTE WITH/FOR 
NEXT SEGMENT (02) OF DATA SET $EDXL 

VOLUME NAME: VOLCAN 

COPY OF $EDXL, VOLCAN TO $EDXL,CAN COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS 5803 



A 






\> 
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$HXUT1 - H-Exchange Utility (continued) 



Example 4: Copy an entire multivolume data set to an EDX data set. The multivolume data 
set spans two diskettes but only contains 161 records. You will need only one diskette to hold 
the EDX data set because 3848 records are allocated in the target data set, and the source 
H-exchange data set has less than 3848 records. When the prompt 'HOW many diskettes 
(1-99)' is issued, you can enter 1. 






COMMAND (?): RX 

SOURCE EXCHANGE DATA SET (NAME, VOLUME): $EDXL,CANTST 
COPY ENTIRE DATA SET? (Y/N): 

TARGET EDX DATA SET (NAME, VOLUME): $EDXL,CAN 

HOW MANY DISKETTES (1-99): 1 

$EDXL ALLOCATED, SIZE IS 38A8 RECORDS 

THIS IS A MULTIVOLUME COPY 

SOURCE MAY NOT FIT INTO TARGET 

PLEASE MOUNT DISKETTE WITH/FOR 
NEXT SEGMENT (02) OF DATA SET $EDXL 

VOLUME NAME: VOLCAN 

COPY OF $EDXL, VOLCAN TO $EDXL,CAN COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS 161 
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$HXUT1 - H-Exchange Utility (continued) 

UD — Update H-Exchange Data Set Label by Name 

Use the UD command to update the data set definition or (hdri) label by entering the data set 
name associated with that label. If a field is not in conformity with the standard, the utility lets 
you know about it. In the following example, the end of data extent is changed from Oil 23 to 
40001, and the write protect indicator is set. 



COMMAND (?): UD 

DATA SET NAME: ACCTREC 

HEADER IDENTIFIER LABEL (NOW IS 'HDRI'): 

DATA SET NAME (NOW IS 'ACCTREC '): 

BLOCK LENGTH (NOW IS ' 256'): 

RECORD ATTRIBUTE (NOW IS ' '): 

BEGINNING OF EXTENT (NOW IS '01123'): 

PHYSICAL RECORD LENGTH INDICATOR (NOW IS ' '): 

END OF EXTENT (NOW IS '^+0001'): 

RECORD/BLOCK FORMAT (NOW IS ' '): 

BYPASS INDICATOR (NOW IS ' '): 

SECURITY INDICATOR (NOW IS ' '): 

WRITE PROTECT INDICATOR (NOW IS ' '): P 

EXCHANGE TYPE (NOW IS 'H'): 

MULT I VOLUME INDICATOR (NOW IS 'C'): 

VOLUME SEQUENCE NUMBER (NOW IS '02'): 

CREATION DATE (NOW IS ' '): 

RECORD LENGTH (NOW IS ' '): 

OFFSET TO NEXT RECORD SPACE (NOW IS ' '): 

EXPIRATION DATE (NOW IS ' '): 

VERIFY/COPY INDICATOR (NOW IS ' '): 

DATA SET ORGANIZATION (NOW IS ' '): 

END OF DATA (NOW IS '01123'): ^0001 

SYSTEM CODE (NOW IS 'IBMEDXSI'): 

FILE ACCESS TYPE (NOW IS ' '): 



O 



V 



If listing redirection is in affect, using the Li command, the system requests no input. 



\J 
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$HXUT1 - H-Exchange Utility (continued) 

UH — Update H-Exchange Data Set Label by Number 

Use the UH command to update the data set definition or (hdri) label by entering the positional 
number for the label. Enter N to refer to the Nth label. If a field is not in conformity with the 
standard, the utility lets you know about it. 






COMMAND (?): UH 
HDRI NUMBER: 13 



IS 



HEADER IDENTIFIER LABEL (NOW IS 'HDRl') 
DATA SET NAME (NOW IS 'ACCTREC'): 
BLOCK LENGTH (NOW IS '256' ): ' 

RECORD ATTRIBUTE (NOW IS ' '): 
BEGINNING OF EXTENT (NOW IS '01123'): 
PHYSICAL RECORD LENGTH INDICATOR (NOW 
END OF EXTENT (NOW IS '40001'): 
RECORD/BLOCK FORMAT (NOW IS ' '): 
BYPASS INDICATOR (NOW IS ' '): 
SECURITY INDICATOR (NOW IS ' '): 
WRITE PROTECT INDICATOR (NOW IS ' '): 
EXCHANGE TYPE (NOW IS 'H'): 
MULT I VOLUME INDICATOR (NOW IS 'C'): 
VOLUME SECIUENCE NUMBER (NOW IS '02'): 
CREATION DATE (NOW IS ' '): 
RECORD LENGTH (NOW IS ' '): 
OFFSET TO NEXT RECORD SPACE 
EXPIRATION DATE (NOW IS ' 
VERIFY/COPY INDICATOR (NOW IS 
DATA SET ORGANIZATION (NOW IS 
END OF DATA (NOW IS '01123'): 
SYSTEM CODE (NOW IS 'IBMEDXSI') 
FILE ACCESS TYPE (NOW IS ' '): 



(NOW IS 
'): 



40001 



UV — Update H-Exchange Volume Label 



Use the UV command to update the volume label. If a field is not in conformity with the 
standard, the utility will let you know about it and force you to reenter it. 



COMMAND (?): UV 

VOLUME LABEL IDENTIFIER (NOW IS 'VOLCAN'): 
VOLUME NAME (NOW IS 'VOLCAN'): 
ACCESSIBILITY INDICATOR (NOW IS ' '): 
SYSTEM CODE (NOW I S ' I BMRPSST ) : IBMEDXSI 
OWNER IDENTIFIER (NOW IS ' '): J SMITH 
LABEL EXTENSION INDICATOR (NOW IS ' '): 
VOLUME SURFACE INDICATOR (NOW IS 'M'): 
EXTENT ARRANGEMENT INDICATOR (NOW IS ' '): 
SPECIAL REQUIREMENTS INDICATOR (NOW IS ' ') 
PHYSICAL RECORD LENGTH (NOW IS '1'): 
PHYSICAL RECORD SEQUENCE CODE (NOW IS ' '): 
STANDARD VERSION (NOW IS 'W'): 
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$HXUT1 - H-Exchange Utility (continued) 

WX — Write H-Exchange Data Set From EDX Data Set 

Use the wx command to copy an EDX data set to an H-exchange data set. The H-exchange data 
set is allocated automatically according to the rules described in the explanation of the allocate 
command (al). If the source data set will not fit onto the target volume, the system requests 
new diskette volumes. Partial copies are supported. 

Note: You must enter the H-exchange volume name. There is no default value defined. 

Example 1 : Copy a small EDX data set to a single volume H-exchange data set. 



COMMAND {?): WX 

SOURCE EDX DATA SET (NAME , VOLUME) : CUSTF I LE ,EDX003 
COPY ENTIRE DATA SET? (Y/N): Y 

TARGET EXCHANGE DATA SET (NAME .VOLUME ) : CUSTF I LE ,CANTST 
CUSTFILE ALLOCATED, SIZE IS 123** RECORDS 

COPY OF CUSTFILE, EDX003 TO CUSTF t LE ,CANTST COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS mk 



Example 2: Copy a partial edx data set. 



r 



COMMAND (?): WX 

SOURCE EDX DATA SET (NAME , VOLUME) : 
COPY ENTIRE DATA SET? (Y/N): N 
STARTING RECORD NUMBER: 10 
COPY TO END OF DATA SET? (Y/N): Y 



CUSTFILE, EDX003 



TARGET EXCHANGE DATA SET (NAME .VOLUME ) : 

STARTING RECORD NUMBER: 5 

CUSTFILE ALLOCATED. SIZE IS 20 RECORDS 



CUSTFILE.CANTST 



COPY OF CUSTFILE, EDX003 TO CUSTF I LE .CANTST COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS 16 
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$HXUT1 - H-Exchange Utility (continued) 






Example 3: An edx data set may be too large to fit on a single data set. If so, the utility 
prompts you for the name of the volume where the next portion of the data set is to be copied. 



$EDXL,ASMLIB 



COMMAND (?): ^^x 

SOURCE EDX DATA SET (NAME .VOLUME ) 

COPY ENTIRE DATA SET? (Y/N): Y 

TARGET EXCHANGE DATA SET (NAME .VOLUME) : $EDXL,CANTST 

$EDXL ALLOCATED, SIZE IS 48 RECORDS 

THIS ISA MULT I VOLUME COPY 

PLEASE MOUNT DISKETTE WITH/FOR 
NEXT SEGMENT (02) OF DATASET $EDXL 



VOLUME NAME; 



VOLCAN 



$EDXL ALLOCATED, SIZE IS 113 RECORDS 

COPY OF SEDXL.ASMLIB TO $EDXL, VOLCAN COMPLETE 
TOTAL NUMBER OF RECORDS COPIED WAS l6l 



J 
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$IMAGE - Define Formatted Screen Image 



You can use $image to create formatted screen images for use with terminals that support static 
screen functions (for example, 4978, 4979, 4980, or 3101 block mode display terminals). The 
system stores the image (a formatted screen) in a disk or diskette data set for later retrieval by 
application programs or by this utility for modification. 



Data Set Requirements 



Before you invoke $image, use $diskliti 4:a allocate a disk or diskette data set to store the 
formatted screen image created by $image. The formatting information and text are stored in a 
compressed format to conserve space. A stored screen may be any size from one character 
position up to an entire physical screen; therefore, the amount of space on disk or diskette 
required to store a given screen image varies. For most 4978 and 4980 static screens, a data set 
two records in length is adequate. For complex 4978 and 4980 screen formats, a data set 8 
records in length is recommended; for complex 3101 screen formats, a data set 15 records in 
length is recommended. 



Considerations for Using $IMAGE 



$IMAGE contains a fixed-size buffer that is used in the creation of screens. Protected data fields 
are placed in the buffer first and then any remaining space is used for unprotected data fields. 
As a result, the number of unprotected data fields on a screen that can have predefined data is 
dependent upon the number of protected data fields. 

$IMAGE can format 4978 and/or 3101 images, depending on your requirements. The formatted r j 

screen subroutines provide support for both 4978 and 3101 displays by selecting the appropriate \-# 

parameters. With these subroutines, you can use 4978 or 4980 images for the 4978, 4980, or 

the 3101. However, the 3101 supports fewer unprotected data fields with default data than the 

4978 or 4980. Therefore, the migration of a 4978 or 4980 image to the 3101 may result in the 

truncation of default data within the unprotected data fields. This truncation does not cause the 

actual unprotected or protected fields to be lost; however, insufficient ftab space within an 

application will make it appear to be lost. The message "3101 UNPROTECTED DATA 

TRUNCATED" is a warning to be aware that the size of your FTAB buffer must be larger than 

the average size (300 words) used in $IMAGE. $IMAGE expands its own ftab area whenever you 

specify a sufficiently large dynamic storage area at load time. If your display is a 3101 image, 

you select a subroutine that processes 3101 images. For a description of the formatted screen 

subroutines, $imdata, $imdefn, $imopen, and $improt, see the Event Driven Executive 

Language Programming Guide. 

The system sets end-of-file to indicate if a 3101 datastream is included with the 4978 or 4980 
format. Therefore, you should use formats only with application programs or $image and not 
other utilities. 

Note: If you define screens with eol/eof or del keys, the system inserts blanks in the 3101, 
4978, and 4980 screen images. 



\J 
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$IMAGE - Define Formatted Screen Image (continued) 

Formatting Screens with $IMAGE 

Formatting a screen image on a 4978 or 4980 consists of defining protected and unprotected 
areas. The 3101, however, uses attribute characters to further define the visual characteristics 
of protected and unprotected areas. Attribute characters appear as protected blanks on the 
display screen. Hence, the characters preceding and following an unprotected area (input area) 
appear as protected blanks. These attribute characters must be taken into account when 
designing a screen image that will be displayed on the 4978, 4980, and/or the 3101. A 
description of defining the screen formats for the 4978, 4980, and the 3101 terminals follows. 

For an aid in laying out the format of the screen to be defined, refer to the IBM 3270 
Information Display System Layout Sheet, GX27-2951. 

4978/4980 Screen Format 

Visualize a screen format for a 4978 and 4980 as a matrix (usually 24 x 80) of characters that 
directly represents the image displayed on the screen. The system displays a character at 
position (m,n) in this matrix at position (m,n) on the screen. A character can possess only one 
attribute in a 4978 and 4980 image: its protection status (protected or unprotected). As a 
result, you do not need to specify explicit attributes for characters. Character positions on a 
4978 or 4980 screen are defined as follows: 

• Protected — positions on the screen where data values are entered during the protected field 
definition mode (PFl). Once the screen is formatted, these positions will remain as defined 
until you enter PFl mode again and change them. 

• Unprotected — positions defined with a specified null character during the protected field 
definition mode (PFi) and referred to as the input fields (areas on the screen that accept 
operator input). After you have defined the unprotected fields in PFl mode, you can modify 
these positions to contain data values by entering the unprotected field definition mode 

(PF2). 

Characters in protected positions are displayed with low intensity; those in unprotected positions 
are displayed with high intensity. 

For an example of formatting a screen image on a 4978 or 4980, refer to the program 
preparation example in the Event Driven Executive Language Programming Guide. 
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3101 Screen Format 



A screen format designed for a 3101 can also be visualized as a matrix (usually 24 x 80) that 
directly represents the image previously defined on the display. Additionally, the format consists 
of attribute characters for use only on a 3101 display. Fields on the display are defined as either 
protected or unprotected (specified by the defined null character). The attribute characters 
define the visual attributes of the characters that will follow on the display. Since a number of 
possible attributes exist, you can format portions of the display into fields by assigning the 
following attributes. 

• High intensity — the characters in a designated field are displayed in a higher intensity than 
the rest of the display 

• Low intensity — the characters in a designated field are displayed in normal intensity 

• Nondisplay — the characters in a designated field are not displayed 

• Blinking — the characters in a designated field blink. 

Note: If you do not use attribute characters, then protected positions are displayed in low 
intensity; unprotected positions are displayed in high intensity. However, if the first position on 
the 3101 display is unprotected, the entire first field will be displayed in low intensity. On the 
3101, you can define these areas with other attributes, such as blinking versus nonbUnking or 
display versus nondisplay. 

Once you have created a screen image using the attribute bytes, each attribute byte occupies a \^ 

character position on the display and is visually represented by a blank. As a result, the 
characters preceding and following unprotected fields always appear as protected blanks on a 
3101 display. This is because attributes are defaulted, if not explicitly specified, between the 
protected and unprotected fields on a 3101 display. 
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Displaying Screens 



When you display a screen designed for a 4978 or 4980 on a 3101, the character preceding and 
following each unprotected field becomes a blank. This may necessitate slight modifications to 
such screens. For example, if you have not allowed for proper spacing, you can lose a portion of 
a protected field. The following areas on a 4978 or 4980 display 



L 



NAME:@@@@@< — (5 characters) 



will be displayed on a 3101 as follows: 
I NAME @@@@@ --(5 characters) 



On the 3101 display, the last character (:) in the first protected field and the first character (<) 
in the second protected field are lost because the characters preceding and following the 
unprotected field appear as protected blanks and overlay the data values defined in those 
protected positions. 

Screen formats designed for a 3101 that have attribute characters defined can be displayed on a 
4978 or 4980. The attribute characters (protected blanks) are ignored and the fields default to 
the protected and unprotected areas as defined. 



'IV 

•^ Invoking $IMAGE 



You invoke $image with the $L operator command or option 4.4 of the session manager. 

> $L $ I MAGE 

LOADING $IMAGE 78P ,00:44: 30, LP= 9200, PART=1 

COMMAND (?): 
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$IMAGE - Define Formatted Screen Image (continued) 

$IMAGE Commands 

When you load $image, it is in command mode and you can choose any of the available 
commands. To display the $image commands at your terminal, enter a question mark in reply 
to the prompting message command (?):. 



COMMAND(?): ? 

ATTR -- DEFINE ATTRIBUTE CHARACTERS 

DIMS -- DEFINE SCREEN DIMENSIONS 

EDIT -- EDIT SCREEN FORMAT 

FTAB — DISPLAY FIELD TABLE 

HTAB -- SET (HORIZONTAL) TABS FOR EDIT 

KEYS — DISPLAY USE OF PF KEYS 

NULL -- DEFINE NULL CHARACTER 

PRNT — PRINT SCREEN IMAGE AND TABLES 

SAVE — SAVE SCREEN FORMAT{S) IN DATA SET 

VTAB -- SET (VERTICAL) TABS FOR EDIT 

END -- END PROGRAM 



COMMAND(?) 



V 



J 



After $IMAGE displays the commands, it prompts you again with command (?):. Then you can 
respond with the command of your choice (for example, dims). 

Notes: 

1 . You can enter these commands in command mode only. They are not available in edit 
mode. Therefore, you should define the null character, the dimensions, and the tab settings 
before you enter edit mode (edit). 

2. The values you enter for the attr, dims, htab, null, and vtab command remain in effect 
until you change them or you end the utility. 

3. If the message "INTERNAL 3101 DATA STREAM TOO LARGE" appears when you 
enter the edit command, then you must increase the size of the buffer containing the 3101 
data stream. This can be done only when you load $image by specifying a sufficiently large 
value for the storage parameter on the $L command. (Example - $L $image„6000.) If you 
do not specify this value, it defaults to 4608. 



v.,y 



vv 
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ATTR — Define Attribute Characters 



^^^ 



Use the ATTR command to define the characters that represent the attribute bytes on a 3101 
display screen. You are prompted with the type of attribute and its existing value. If you do not 
enter a new character to represent the attribute byte, it defaults to the character displayed. If 
you wish to delete an attribute character, enter a space to represent the attribute byte. 

Note: You must not use an attribute character as a character on the protected portion of the 
screen. For example: 

N 

COMMAND (?): ATTR 

ATTRIBUTE CHARACTERS WITH MDT OFF: 

LOW INTENSITY (NOW IS ' ') = % 

HIGH INTENSITY (NOW IS ' ' ) = " 

BLINKING (NOW IS ' ') = $ 

NONDISPLAY (NOW IS ' ') = & 

DO YOU WISH TO DEFINE ATTRIBUTE CHARACTERS WITH MDT ON? N 
COMMAND (?): 



Once you define attribute bytes, you can change them by issuing the ATTR command again. The 
ATTR command will display the attribute bytes that are currently defined in the (NOW IS ' ') 
portion of the prompt and you can change or delete the attribute characters that you no longer 
need. 

If you define an attribute character that is already in use, the following warning message is 
issued. 



I 



CHARACTER ALREADY IN USE (WARNING) 



If you replace a previously defined attributed character with a blank, the following message is 
issued: 



L 



CHARACTER REMOVED 



If you do not enter a character in response to the prompt, the following message is issued: 



L 



CHARACTER NOT CHANGED 
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$IMAGE prompts you as to whether or not you want to define characters with the modified data 
tag (mdt) on. If you respond Y, the fields specified with that particular attribute character will 
be flagged as having been modified by the operator you can access them with the readtext 
instruction. 



DIMS — Define Screen Dimensions 



Use the dims command, followed by the number of Unes and the line size, to define the 
dimensions of the new screen image you are creating. For example: 



DIMS 10 20 (10 20-character lines) 

DIMS 2^* 80 (full screen image) 



Defining the dimensions for a new screen image will destroy any previously defined screen 
image that has not been saved. 

Note: To define a screen image format for the 3101 so that the attr command may be used to 
specify attribute bytes, the dimensions of the screen must be 24 x 80. 



EDIT — Enter Screen Mode 



Use the edit command to place $image in edit verification mode. If you are going to edit an 
existing screen image, enter the data set name and volume containing the image with the edit 
command. If you are creating a new screen image, enter edit without reference to a data set. 

Notes: 

1. If you are modifying an existing screen image, you must redefine the null character each time 
you invoke $image.. 

2. The volume, if unspecified, defaults to the ipl volume. If you do not specify a data set 
name, then the program displays the currently defined image. 

Examples 

EDIT 

EDIT I MAGE 1 
EDIT IMAGEB,EDX002 
V 






c 
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$ I MAGE - Define Formatted Screen Image (continued) 



END — End$IMAGE 



Use the END (or en) command to end the $IMAGE utility. If the screen image has been modified 
since the last save operation, the following question is issued: 



I 



SAVE FINAL IMAGE? 



Respond Y to save the image, N if you don't want it saved. 
FTAB — Display Field Table 

Use the ftab command to display or print a table, created by $image, containing the field, row, 
column, size, and attributes of the unprotected fields in the last screen image created or edited. 
The table is printed on the device labeled SSYSPRTR unless you specify another device. For 
example: 



*^' 



FTAB 
FTAB 



(prints on $SYSPRTR) 

(displays on terminal that issued 
the command) 



FTAB $SYSLOGA (prints on device labeled as 
the alternate logging device) 



If the device you specify is not defined, the table is displayed on the terminal that issued the 
FTAB command. 



Following is an example of a table displayed by ftab where the character @ is defined as an 
attribute character by the attr command: 

FIELD ROW COLUMN LENGTH ATTRIBUTE 



v_ ^ 

Only a screen image formatted with dimensions equal to 24 x 80 will contain the attribute 
characters defined for each field. 



1 


7 


^46 


15 


2 


10 


i*6 


15 


3 


13 


^6 


3 


k 


16 


i46 


8 


5 


20 


^9 


1 
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HTAB — Set (Horizontal) Tabs for Edit 

Use the htab command to define the horizontal tab settings to be in effect during edit mode. 
For example: 



o 



I 



HTAB 10 15 20 40 kS 50 73 



If you do not define htab, it defaults to the following settings: 10, 20, 30, 40, 50, 60, and 70. 
The tab settings allow you to position the cursor to the corresponding display positions with the 
PFl key in edit mode. If a tab value exceeds the line size or is not in ascending order, then the 
cursor moves to the next line when the invaUd setting is encountered. 



KEYS — Display Use of PF Keys 



Use the keys command to list the functions of the PF1,PF2, and PF3 keys immediately after you 
enter the edit mode. 



COMMAND(?): KEYS 

PFl - MODIFY PROTECTED FIELDS 
PF2 - MODIFY DATA FIELDS 
PF3 - ENTER COMMAND MODE 

COMMAND(?): 
V 



Once you have chosen either PFi or pf2 to enter data, pfi and PF2 function as the horizontal and 
vertical tab keys (respectively) when you are defining protected or data fields in edit mode. 



\J 



\^J 
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NULL — Define Null Character 









Use the NULL command to define a character that is interpreted as the null character during 
editing of the image. In edit mode, you enter a null character in each position in which you want 
to display unprotected data or which is to accept data entered by the operator. For example: 



COMMAND (?) 
COMMAND (?) 
COMMAND (?) 



NULL . 
NULL , 
NULL 



Once you have defined the null character, you can change it by issuing the null command 
again. You are prompted with the existing value for the null character. The NULL command 
displays the null character currently defined in the (NOW IS ' ') portion of the prompt. If you 
do not enter a new character to represent the null character, it defaults to the character 
displayed. For example: 

COMMAND (?): NULL 

NULL (NOW IS ',') = 



If you define a null character that is already in use, the following warning message is issued: 

NULL CHARACTER ALREADY IN USE (WARNING) 



I 



If you replace a previously defined null character with a blank, the following message is issued: 



I 



CHARACTER REMOVED 



If you do not enter a character in response to the prompt, the following message is issued: 
I NULL CHARACTER NOT CHANGED 

Notes: 

1. If you are modifying an existing screen image, you must redefine the null character each time 
you invoke $IMAGE. 

2. If the NULL command is not defined prior to an editing session, the null character defaults to 
a period (.). As a result, all periods defined as protected assume an unprotected status in 
subsequently edited screens. 
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$IMAGE - Define Formatted Screen Image (continued) 

PRNT — Print Screen Images and Tables 

Use the FRNT cominatid to display or print the screen itna^ of the last sateen created or edited 
as it appears when in H^l mode (protected field definition mode). The screen image is printed 
on the device labeled $SYSPkTR unless you specify another device. For example: 



PRNT 
PRNT 



(prints on $SYSPRTR) 

(displays on terminal that issued 
the command) 



V 



PRNT $SySLOGA (prints on device labeled as 
the alternate logging device) 



J 



If the device you specify is not defined, the screen image is displayed on the terminal that issued 
the PRNT command. 

The screen image displayed by PRNT is surrounded by a box numbered in increment of five to 
allow column verification. The defined null character is displayed and, if the dimensions of the 
screen equal 24 x 80, the defined attribute characters are also displayed. 

Sample PRNT displays: The dimensions of the following screen image do not equal 24 x SO; 
therefore, defined attribute characters are not displayed. 



12 40 







10 



15 



20 



25 



30 



35 



0+$IMAGE SOBSCREEN +0 

1 I 

I UNPROTECTED FIELDS WITHOUT DEFAULT DATA| 

I FIELDl FIELD2 FIELD3 . | 

I 
5+UMPROTECTED FIELDS WITH DEFAULT DATA 
I FIELD4 - FIELD5 FIELD6 - 

I 






I 

10+ 



I THIS SCREEIM IS 12 BY 20 IN SIZE 



10 



15 



20 



25 



30 



I 
+5 

1 
1 
1 
I 
+10 



35 



NOLL CHARACTER IS 



The dimensions of the following screen image equal 24 x 80; therefore, FRNT displays the 
defined attribute characters used in formatting the screen image. 
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$IMAGE - Define Formatted Screen Image (continued) 

DIMS: 24 80 

5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 

+ $SMM0209: SESSION MANAGER $UPDATE PARAMETER INPUT MENU '■ + 

I ENTER/SELECT PARAMETERS: DEPRESS PF3 to RETURN I 

1 I 

I I 

I I 

5+ +5 

I I 

I OBJECT INPUT (NAME, VOLUME) ===========> I 

I I 

I I 

10+ PROGRAM OUTPUT (NAME , VOLUME) ===========> +10 

I I 

I I 

I REPLACE (ENTER YES IF PROGRAM EXISTS) ==> ... I 

I I 

15+ +15 

I LISTING (TERMINAL NAME / *) ============> I 

I I 

I I 

I NOTE: THE OBJECT INPUT<- PROGRAM OUTPUT AND LISTING TERMINAL NAME ARE I 

20+ REQUIRED PARAMETERS AND MUST BE ENTERED. +20 

I AN '*' MAY BE USED TO SEPCIFY THIS TERMINAL AS THE LISTING TERMINAL I 

I I 

I I 

5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 

NULL CHARACTER IS ' . ' 

ATTRIBUTE CHARACTERS WITH MDT OFF: 
LOW INTENSITY IS ' ' 
HIGH INTENSITY IS ' ' 
BLINKING IS ' ' 
NONDISPLAY IS ' ' 

ATTRIBUTE CHARACTERS WITH MDT ON: 
LOW INTENSITY IS ' ' 
HIGH INTENSITY IS ' ' 
BLINKING IS ■ ' 
NONDISPLAY IS ' ' 



SAVE — Save Screen Format(s) in Data Set 



Use the SAVE command to save the screen image format. If you do not specify a data set name 
with the SAVE command, you are issued a prompt asking you if you wish to save the format on 
the previously specified data set. For example, if you edited a data set billscrn,scrns, the 
following occurs. 

COMMAND (?): SAVE 

SHOULD THE 3101 DATASTREAM BE SAVED? N 

SAVE FORMAT ON B I LLSCRN ,SCRNS? Y 
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$IMAGE - Define Formatted Screen Image (continued) 

If you respond with an N, you are prompted for a new format data set name as follows: 
I ENTER FORMAT DATA SET NAME: 

The formatting information and text that define the image are stored in the data set in a special 
packed format. For packed format information, refer to the Event Driven Executive Language 
Programming Guide. Some examples are: 



SAVE 




SAVE 


IMAGE2 


SAVE 

V 


IMAGE2,EDX003 



If the dimensions of the screen image are 24 x 80, you are prompted as follows: 
I SHOULD THE 3101 DATASTREAM BE SAVED? 



J 



If you respond Y, the image will be saved in the same data set as the 4978 or 4980 screen image 
and later retrieved for display on the 3 101. You can also perform this operation by using the 
DSOPEN subroutine or defining the data set at program load time and issuing the disk READ 
instruction. For more information on retrieving screen image format, see the $imopen 
subroutine in the Event Driven Executive Language Programming Guide. 

When the image has been saved, the following messages appear, with the number of 256-byte 
records indicated in parentheses. 






THE FORMAT(S) WILL BE SAVED ON data set 
SAVED (n RECORDS) 



V 



4978 FORMAT REQUIRES xxxx BYTES 
3101 FORMAT REQUIRES yyyy BYTES 



Note: If the data set you specified does not exist, it is allocated automatically. If the specified 
data set exists but is too small to contain the format(s), it is deleted and a new one allocated. 
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VTAB — Set (Vertical) Tabs for Edit 



Use the vtab command to define vertical tab settings to edit the screen image conveniently by 
columns rather than rows. The default vertical tabs range from 1 to 24 in 1-line increments. 
You can redefine these as in the following example: 



I. 



VTAB 5 10 20 2^4 



In edit mode, when you press the pf2 key (vertical tab key), the cursor moves to the next line 
indicated at the last encountered horizontal tab setting. When the last vertical tab setting is 
passed, the cursor moves to line at the next horizontal tab setting. 



Entering Edit Verification iVIode 






Once you have defined the null character, the dimensions, and the tab settings, the last 
command you enter is edit, edit places $IMAGE into edit verification mode. If you will be 
editing an existing screen image format, the dimensions used will be those of the save screen 
image format. Otherwise, edit is entered without reference to a data set. Edit verification 
mode displays the screen image as you would see it using the $iMOPEN, $IMDEFN, $lMPROT, and 
$IMDATA subroutines. See the Event Driven Executive Language Programming Guide for 
information on using these subroutines. 

When you enter edit verification mode, the PF keys have the following functions: 

• PFl — define protected fields 

• PF2 — define data fields (unprotected) 

• PF3 — return to command mode 

However, as soon as you press either PFl or PF2 entering edit verification mode (indicating 
definition of protected or unprotected fields), the function of PFl andPF2 is redefined. PFl is 
then used as the horizontal tab key and pf2 as the vertical tab key. 

To exit protected or unprotected mode and return to edit verification mode, press the ENTER 
key. 

The following figure shows the functions available under $IMAGE. However, its primary purpose 
is to show the sequence of events that occurs when $image enters edit mode. 
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> $L$IMAGE 



Command mode 



ATTR 
DIMS 
FTAB 
HTAB 
KEYS 
PRNT 
SAVE 
VTAB 



END 
$IMAGE 



EDIT 



Edit verification mode 





Indicates to $IMAGE 
definition of 
protected data 
PF1 == horizontal 

tab key 
PF2 = vertical 

tab key 
Enter all data 
protected areas with 
data values and 
unprotected areas 
with null chars 



PRESS 
ENTER 



■►A 




Indicates to $IMAGE 
modification of 
unprotected data 
PF1 = horizontal 

tab key 
PF2 = vertical 

tab key 
Change null 
characters to 
unprotected data 
values 



- Returns $IMAGE 
to command mode 






PRESS 
ENTER 



— Displays screen as defined 
for verification 
Edit mode taken out of 
protected data definition mode 



-► A 



Displays screen image as defined 
with unprotected data areas 
highlighted for verification 
Edit mode taken out of unprotected 
data definition mode 



Figure 21. $IMAGE - Command and Edit Mode 



\J 



UT-400 SC34-0644 



^JLjij^j)^ 



$IMAGE 

$IMAGE - Define Formatted Screen Image (continued) 



Defining Protected Fields 



When protected and unprotected text is to appear on a screen created by $image, enter the 
protected data first. Press PFl to signal the utility that protected fields are to be defined. 

When you define the protected areas of a screen image, all characters you enter, other than the 
defined null character, are protected data. All areas of the screen that don't contain the null 
character will be protected when the screen is completed. The unprotected areas of the screen 
(indicated with the defined null character) should then be specified. You can modify these 
unprotected areas later to contain contain data values. 

Once all areas (protected and unprotected) on the screen have been defined, press the enter 
key to take the utility out of protected field definition mode. The screen as defined is displayed 
so you can verify if it is correct. PFi and pf2 again have the meanings printed out by the keys 
command and no longer function as tab keys. 



Entering Unprotected Output Fields 



To modify unprotected areas on the image, press pf2. Pressing PF2 allows you to modify the 
unprotected fields and to display the screen showing both the protected areas and the null 
characters representing the unprotected areas. Now you can fill in the unprotected fields with 
data values. You can leave other null fields alone since they will be used as input fields to 
provide information to your application program. 

After you have modified the unprotected fields, press the enter key to take iW utiUty out of 
unprotected field definition mode. The screen as defined is displayed so you can verify if it is 
correct, pfi and pf2 again have the meanings printed out by the keys command and no longer 
function as tab keys. If you want to make any changes to the screen, press PFl to allow 
protected field entry or pf2 to allow unprotected field entry. 



Saving the Image Created 



If the image is correct, press pf3 to return to command mode. The screen is blanked and you 
are prompted for a command. Enter the save command, followed by the name of the data set 
that you allocated for this purpose. The image will be saved and you can end the $IMAGE utility 
with the END command. 
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$INITDSK - Initialize Direct Access Device; Volume Control ^^^ 

o 

$INITDSK performs initialization operations for direct access storage devices. 
$INITDSK performs the following functions: 

• Initialize a device by writing: 

— the volume directory on a disk device or a multivolume diskette, with the option to 
specifying the record number at which the system will write the directory; 

— owner identification on a diskette; 

— the volume label on a single- volume diskette; 

— a data set directory in a disk or diskette volume; 

— IPL text on a disk or diskette device. 

• Allocate a: 

— volume on a disk device or multiple- volume diskette; 

— volume under the fixed heads of a disk device. 
Delete a volume on a disk device or multiple volume diskette. 
List the volume(s) on a disk or diskette device. 
Split a disk or multiple volume diskette volume into two volumes. 

Verify a volume by reading all or part of a disk or diskette volume and hsting any i/o errors. 
Verify a device by reading all or part of a disk or diskette and Usting any I/O errors. 
Rename a volume on a disk or multivolume diskette device. 
Rename a diskette VOLl label and owner id. 



Invoking $INITDSK 



You invoke $INITDSK with the $L operator command, option 3.7 of the session manager, or 
through the $dasdi utihty. During diskette initialization for Event Driven Executive format, 
$DASDI gives you the option of going directly into $initdsk operation without having to end 
$DASDI and issue the $L command for $INITDSK. You must vary diskette devices online before 
you invoke $initdsk. 



o 



o 
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$INITDSK- Initialize Direct Access Device Volume Control (continued) 



$INITDSK Commands 






To display the $initdsk commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?): 



r 



COMMAND (?): ? 

ID - INITIALIZE DEVICE 

AV - ALLOCATE VOLUME 

AF - ALLOCATE FIXED HEAD VOLUME 

SV - SPLIT VOLUME 

IV - INITIALIZE VOLUME 

I I - INITIALIZE IPL TEXT 

VD - VERIFY DEVICE 

VV - VERIFY VOLUME 

LP - LIST PERFORMANCE VOLUMES 

LV - LIST VOLUMES... LV DEVADDR PRTNAME 

LAV- LIST ALL VOLUMES. .. LAV PRTNAME 

DV - DELETE VOLUMES 

RV - RENAME VOLUMES 

RD - RENAME DISKETTE VOLT /OWNER ID 

WV - SET WRITE VERIFY 

WN - CLEAR WRITE VERIFY 

EN - END PROGRAM 

COMMAND (?): 



After $INITDSK displays the commands, it prompts you again with command (?):, Then you can 
respond with the command of your choice (for example, SV). 






Note; When you specify a volume for the SV, IV, and VV commands, you must make the volume 
name unique. If $INITDSK finds duplicate names, it uses the first one it finds. 

Each command and its explanation appears in alphabetical order on the following pages. 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



AF — Allocate Fixed-Head Volume 



Use the AF command to allocate the fixed-head area of a disk as a separate volume. Enter 
information about the volume in the volume directory for the device. 

You cannot use AF for diskette devices. 

Example: Allocate a fixed-head volume. 

COMMAND (?): AF 
DEVICE ADDRESS: A8 
VOLUME NAME: FHVOL 
FHVOL ALLOCATED 

COMMAND (?): , 

V J 



AV — Allocate Volume 



Use the AV command to allocate a volume on a disk or multivolume diskette device. AV 
allocates one volume at a time; for multiple volumes, you must use AV repeatedly for each 
volume you allocate. $initdsk prompts you for the following information: 

• The address (in hexadecimal) of the device you want allocated. 

• The name (1-6 characters) of the volume you want allocated. 

• The number (in decimal) of the records within the volume. 

A volume can contain from three records to the maximum number of records on a single device. 
Enter information about the volume in the volume directory for the device. In addition, AV 
gives you the option of initializing (writing) a data set directory for the volume you are 
allocating. You must have a data set directory before you can allocate individual data sets. 

Once you allocate a volume, you may want to: 

1 . Initiahze (iv) the volume just allocated. 

2. Set (wv) the write verify function on. 

3. Copy the current system nucleus to the volume just allocated. 

4. Write (ii) IPL text to point to the system nucleus. 

The AV command prompts you for these steps. If you do not want to perform any of these 
functions, respond N to step 1. You can also perform these functions by using the IV, WV, and II 
commands individually. For an explanation of each step, see the individual command. 






XJ 
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$1NITDSK - Initialize Direct Access Device Volume Control (continued) 



Example 1 : Allocate and initialize a disk volume. 






COMMAND (?): AV 

DEVICE ADDRESS: ^8 

VOLUME: EDX002 

SIZE IN RECORDS: 50000 

EDX002 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 10 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? 

ALLOCATE $EDXNUC? N 

VOLUME INITIALIZED 

COMMAND (?): 



Example 2: Allocate and initialize a disk volume, set write verify on, copy the system nucleus, 
and write the IPL text to point to the system nucleus copied to the volume. 



48 



COMMAND (?): AV 

DEVICE ADDRESS: 

VOLUME: EDX002 

SIZE IN RECORDS: 50000 

EDX002 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 10 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? 

ALLOCATE $EDXNUC? Y 

VOLUME INITIALIZED 

INITIALIZE IPL TEXT? Y 

IPL TEXT WRITTEN 

COMMAND (?): 



Example 3: Allocate and initialize a diskette volume. 



COMMAND (?): AV 

DEVICE ADDRESS: 02 

VOLUME: MYVOL 

SIZE IN RECORDS: 5000 

MYVOL ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 10 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? 

VOLUME INITIALIZED 

COMMAND (?): 



N 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

DV — Delete Volumes 

Use the DV command to delete a volume. Then you can reallocate the volume with the AV or af 
commands. When you delete a volume, you can no longer access the data within that volume. 
$INITDSK prompts you for the address and name of the volume you want deleted. 

Example: Delete a volume. 



COMMAND (?): DV 
ADDRESS: 03 
VOLUME: EDX002 
EDX002 DELETE? Y 
EDX002 DELETED 



EN — End$INITDSK 



Use the en command to end the $initdsk utility. 



Example: End$iNiTDSK. 



V^ 



COMMAND: EN 

$INITDSK ENDED AT 00:06:59 



\^ Jut 



i~^' 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



ID — Initialize Device 






Use the id command to write the volume directory on a 4962, 4963, 4967, DDSK-30 ,DDSK-60 
disk device, or a multiple volume diskette. 

Note: Be sure to format a new diskette with primary option 1 of the $DASDI utiUty before 
initializing it with the ID command. 

You must initialize each disk device with a volume directory which INITDSK writes at a default 
record number. When you use id, you may write the directory number to a record number other 
than the default. $initdsk prompts you for the size of the device, the directory default, and its 
current record number. Once you use id, you can no longer access the data that the disk device 
or multiple volume diskette contained previously. 

ID also writes a volume label and owner identifier on a diskette. The volume label must be 1 to 
6 characters; the identification must be 1 to 14 characters. 

Once you initialize a disk or diskette, you may want to: 

1. Allocate a volume (s) or a fixed-head volume on the disk. 

2. Initialize the disk or diskette volume(s). 

3. Set write verify on. 

4. Copy the current system nucleus. 

5. Write IPL text on a disk or diskette volume. 

The ID command prompts you for all of the above steps for disk or multiple volume diskette and 
steps 2 and 5 for diskette to perform these functions. You can also perform the functions by 
invoking the AF, AV, II, IV, or wv commands individually. 



Chapter 4. Utilities UT-407 



$INITDSK _^ 

$INITDSK - Initialize Direct Access Device Volume Control (continued) 



Example 1: Initialize a disk volume. Sinitdsk prompts you for the information required to 
initialize a disk volume. 



COMMAND (?): ID 
DEVICE ADDRESS: ^8 

DEVICE ALREADY INITtALfZED 
INITIALIZE DEVICE WILL DESTROY ALL DATA 
CONTINUE? Y 

(Do you want to move the directory?) 

THERE ARE 229120 RECORDS IN YOUR DEVICE 

THE DEFAULT OF THE VOLUME DIRECTORY 
FOR THIS DEVICE IS RECORD # 129. 
IT NOW EXISTS AT RECORD # 129. 

DIRECTORY NUMBER OK? N 

(Enter the new record number. The number you enter, 
if you choose to move the directory, is an approximate 
record number. The system calculates the exact record.) 

IN ORDER TO RELOCATE THE VOLUME DIRECTORY IN THE DEVICE, 
THE NEW RECORD NUMBER MUST BE GREATER THAN THE DEFAULT. 

NEW RECORD NUMBER: 50000 

DIRECTORY WILL BE MOVED TO RECORD NUMBER 500^9 
Y 

THE VOLUME DIRECTORY HAS BEEN RELOCATED 
DISK INITIALIZED 

(Do you want to allocate a volume? If you reply Y, 
the next prompt asks if you want a fixed-head volume. If 
you reply Y, the system allocates a fixed-head volume and 
does not use this prompt again in the automatic prompt 
sequence for this disk.) 

ALLOCATE A VOLUME? Y 

IS THE VOLUME A FIXED HEAD VOLUME? Y 

VOLUME: FHVL48 






Figure 22 (Part 1 of 2). Initialize a disic 



%^ 



UT-408 SC34-0644 



$INITDSK 






^taiu***'"' 



$INITDSK - Initialize Direct Access Device Volume Control (continued) 



(Do you want to initialize the volume?) 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 
MAXIMUM NUMBER OF DATASETS: 50 

(Do you want to set write verify on?) 

DO YOU WANT TO WRITE VERIFY FOR THIS VOLUME? N 

(Do you want to allocate space for a system nucleus 
on this volume?) 

ALLOCATE $EDXNUC? N 
VOLUME INITIALIZED 

(The system repeats the prompt sequence for allocating 
a volume, initializing that volume, and writing IPL text 
on the volume. ) 

ALLOCATE ANOTHER VOLUME? Y 

VOLUME: V0L1 

SIZE IN RECORDS: 1000 

VOLl ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 100 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

ALLOCATE $EDXNUC? N 

VOLUME INITIALIZED 

ALLOCATE ANOTHER VOLUME? Y 

VOLUME: V0L2 

SIZE IN RECORDS: 20000 

V0L2 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 100 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

ALLOCATE SEDXNUC? Y 

VOLUME INITIALIZED 

INITIALIZE IPL TEXT? Y 

IPL TEXT WRITTEN 

(The system repeats the prompt sequence until 
you respond N to the a 1 locate-volume prompt.) 

ALLOCATE ANOTHER VOLUME? N 

COMMAND (?): EN 

SINITDSK ENDED AT 01:00:47 



N 



















































V 



Figure 22 (Part 2 of 2). Initialize a disk 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

Example 2: Initialize a single-volume diskette. $initdsk prompts you for volume and IPL text 
initialization. If you initialize the diskette as a multivolume diskette, the system issues a series of 
automatic prompts until you respond N to the allocate-volume prompt. If you do not initiaUze 
the diskette as a multivolume diskette, the series of automatic prompts occurs only once for the 
diskette you are initializing. 



r 



COMMAND (?): ID 
DEVICE ADDRESS: 22 
SLOT NUMBER: 2 

DEVICE ALREADY INITIALIZED 
INITIALIZE DEVICE WILL DESTROY ALL DATA 
CONTINUE? Y 

INITIALIZE DISKETTE AS MULTIVOLUME TYPE? N 
NEW VOLUME LABEL: EDX001 
ENTER OWNER IDENTIFICATION: DEPT A10 
SINGLE VOLUME TYPE DISKETTE INITIALIZED 

(Do you want to initialize the volume?) 

INITIALIZE THE VOLUME? Y 

VOLUME ALREADY INITIALIZED; CONTINUE? Y 

MAXIMUM NUMBER OF DATA SETS: 200 

(Do you want to set write verify on?) 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

(Do you want to allocate space for a system nucleus 
on this volume?) 

ALLOCATE $EDXNUC? Y 
VOLUME INITIALIZED 

(Do you want to write IPL text on the volume?) 

INITIALIZE IPL TEXT? Y 
IPL TEXT WRITTEN 

COMMAND (?): 



4-\ 
%.j^ 



Figure 23. Initialize a diskette 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

Example 3: Initialize a multivolume diskette. 

/ 

COMMAND (?): ID 

DEVICE ADDRESS: 02 

INITIALIZE DEVICE MAY DESTROY ALL DATA 

CONTINUE? Y 

INITIALIZE DISKETTE AS MULTIVOLUME TYPE? Y 

NEW VOLUME LABEL: EDX005 

ENTER OWNER IDENTIFICATION: DEPT A10 

MULTIVOLUME TYPE DISKETTE INITIALIZED 

($INITDSK repeats the prompts for a 
multivolume diskette until you respond 
N to the ALLOCATE A VOLUME? prompt.) 

ALLOCATE A VOLUME? Y 

VOLUME: VOL 1 

SIZE IN RECORDS: 100 

VOL] ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 6 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

VOLUME INITIALIZED 

ALLOCATE ANOTHER VOLUME? Y 

VOLUME: V0L2 

SIZE IN RECORDS: 200 

V0L2 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 6 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

VOLUME INITIALIZED 

ALLOCATE ANOTHER VOLUME? Y 

VOLUME: V0L3 

SIZE IN RECORDS: ^00 

V0L3 ALLOCATED 

INITIALIZE THE VOLUME JUST ALLOCATED? Y 

MAXIMUM NUMBER OF DATA SETS: 12 

DO YOU WANT WRITE VERIFY FOR THIS VOLUME? N 

VOLUME INITIALIZED 

ALLOCATE ANOTHER VOLUME? N 

I COMMAND (?): 

Figure 24. Initialize a multivolume diskette 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



\i J 



Use the ii command to write the ipl text on a disk or diskette volume (the first sector of the disk 
or diskette), ipl text will then point to the IPL target (system nucleus) from which you wish to 
IPL. ayou may use any nucleus as the ipl target. This allows you to define more than one 
supervisor; however, the ipl text includes only one supervisor's location. When you write ipl 
text with the ii command on a specific volume, the system replaces the previous ipl text. 
$INITDSK prompts you for the following information: 

• The name of the system nucleus you want used as the ipl target. You can specify the full 
name of the nucleus, for example, $edxnucx (where x is any alphanumeric character) or 
only the last character of the nucleus name (for example, x for $edxnucx). 

• The name of the volume containing the ipl target nucleus. The system writes ipl text on the 
disk or diskette containing this volume. 

The following two examples show initializing IPL text. The first example shows specifying the 
full name of the system nucleus ($edxnuct); the second shows specifying only the last 
character of the nucleus name (T). The results are the same in each example. 

Example 1: Initialize ipl text; specify full name of nucleus. 



COMMAND .( ? ) : II 
NUCLEUS: $EDXNUCT 
VOLUME: EDX002 
IPL TEXT WRITTEN 



V 



COMMAND (?) 






J 



Example 2: Initialize ipl text; specify only last character of nucleus name (T). 



COMMAND (?): I I 
NUCLEUS: T 
VOLUME: EDX002 
IPL TEXT WRITTEN 

COMMAND (?): 



Notes: 

1 . When specifying the name of the volume you want initialized, specify EDX002 for disk or 
multivolume diskettes; for single-volume diskettes, specify your volume ID. 

2. If you define the IPL nucleus to be other than $edxnuc (allocated by $initdsk), the system 
may move the nucleus if you compress ($C0MPRES) the volume or the device. The ipl text 
then points to the wrong address unless you use 11 to rewrite thclPL text on the volume. 
Also, if the system moves $loader, you must use the starter system from diskette to load 

$INITDSK. 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



IV — Initialize Volume 






Use the IV command to initialize (write) a data set directory in a disk or diskette volume. You 
have allocated the volume using the AV command. $initdsk prompts for the following 
information: 

• The name ( 1 to 6 characters) of the volume you want initialized. 

• The number (in decimal) of data sets you want in the volume. 

• Whether or not you wish to allocate $edxnuc on the volume. 

$INITDSK only prompts to allocate $EDXNUC if the volume is large enough to contain the system 
nucleus. If you respond Y, $INITDSK copies the current $edxnuc from volume EDX002. If you 
have $EDXNUC allocated, $INITDSK also asks if you want the IPL text initialized. If you respond 
Y, it writes the IPL text on the volume and points to the system nucleus that it just copied. This 
allows you to ipl from this volume. If you respond N, the system does not initialize the IPL text. 
To be able to point at a later time to the system nucleus just copied, use the ii command. 

Once you use IV, you can no longer access the data that was on the volume before. 

Note: After you issue an iv to a diskette on a 4964 device, you should open then close the door 
of the 4964. 

Example: Initialize a volume containing $edxnuc. 

COMMAND (?): IV 

VOLUME: EDX002 

MAXIMUM NUMBER OF DATA SETS: 500 

ALLOCATE $EDXNUC? Y 

VOLUME INITIALIZED 

INITIALIZE IPL TEXT? Y 

IPL TEXT INITIALIZED 



V 



COMMAND (?) 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



LAV — List All Volumes 



Use the LAV command to list the volume (s) on all disks or diskettes on the Series/ 1 and the 
number of records in each volume, lav first lists information for the device you are using 
currently and then lists other devices. 

$INITDSK prompts you for the following information: 

• Whether or not you want to list the directory information. 

• Whether or not you want to list the free space chain. 

EDX uses the directory to keep track of the amount of free space available on a volume. You 
can list available free space, if it exists, by responding Y to the list free space chain? prompt. 

You can direct the list to a printer or display station other than the one you are currently using 
by specifying the address of the target device. 






kJ 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

Example: List all volumes. 

Note: FIRST REC is the number of the record containing the first record of the volume, relative 
to the directory. 



f^ 



COMMAND (?): LAV 
DEVICE ADDRESS: 0003 
VOLUME FIRST REC. 



SIZE 



EDX002 121 


11000 


""IPL=$EDXNUCT"" **P 


EDX003 11121 


9000 




ASMLIB 20121 


10000 


""PERFORMANCE VOLUME 


EDXi^O 30121 


7000 




PRGRMS 37121 


2500 




LIST DIRECTORY INFO? Y 






DEVICE SIZE(RECORDS): 




5A000 


DIRECTORY REC. NO.: 




361 


DIRECTORY SIZE(RECS): 




120 


UNUSED DIRECTORY BYTES: 




3042^ 


NO. VOLUME ENTRIES: 




6 


MAX. VOLUME ENTRIES: 




958 


FREE SPACE ENTRIES: 




1 



PERFORMANCE VOLUME' 



DEVICE HAS NO FIXED HEADS 



LIST FREE SPACE CHAIN? Y 



FIRST RECORD 
45771 



SIZE 
7870 



DEVICE ADDRESS: 0002 
SINGLE-VOLUME DISKETTE 
EDXOOl 2220 RECORDS 
COMMAND (?): EN 



J 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

LP — List Performance Volumes 

Use the LP command to list only volumes designated as performance volumes. You can indicate 
the device whose volumes you want listed by entering the command and the device address (in 
hexadecimal). 

Exampte: List performance volumes for disk at device address 03. 



o 



COMMAND 


(?): LP 03 




VOLNAME 


DEVICE 
ADDRESS 


VDE 
ADDRESS 


EDX002 


0003 


076A 
0798 






COMMAND 


(?): 





J 



LV — List Volumes 



Use the LV command to list the volume(s) on a disk or diskette and the number of records in 
each volume. $initdsk prompts you for the following information: 

• The address (in hexadecimal) of the device. 

• Whether or not you want to list the directory information. 

• Whether or not you want to list the free space chain. 

EDX uses the directory to keep track of the amount of free space. If free space exists on the 
volume, you can find it listed under the directory information. $initdsk issues the list free 
SPACE CHAIN? prompt so you can list the location of the free space and its size (number of 
256-byte records). 

You can direct the list to a printer or display station other than the one you are currently using 
by specifying the address of the target device. 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

Example 1 : List volumes on the disk at address 03. 

Note: FIRST REC is the number of the record containing the first record of the volume, relative 
to the directory. 






o 



COMMAND (?): LV 
DEVICE ADDRESS: 03 

DEVICE ADDRESS: 0003 

VOLUME FIRST REC. 



SUPLIB 
ASMLIB 
EDX002 
FHVOL 



121 

2621 

12621 

1 



LIST DIRECTORY INFO? Y 

DEVICE SIZE(RECORDS): 
DIRECTORY REC. NO.: 
DIRECTORY SIZE{RECS): 
UNUSED DIRECTORY BYTES: 
NO. VOLUME ENTRIES: 
MAX. VOLUME ENTRIES: 
FREE SPACE ENTRIES: 
DEVICE HAS FIXED HEADS 



SIZE 

2500 *"PERF. VOL"" 
10000 "*PERF. VOL*" 
23380 *"IPL=$EDXNUC "" ""PERF. VOL' 
i*80 ""FHVOL"* "*PERF. VOL*" 



36240 

2^*1 

120 

30564 

k 

958 





FIXED HEAD-VOLUME IS ALLOCATED 
COMMAND (?): EN 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 

Example 2: List volumes on disk at address 48. 

This list volume example corresponds to Figure 22 on page UT-408 in which the user moved the 
directory to a record other than the default. In addition, this example lists the free space 
available on the volume, first rec is the number of the first record within the free space and 
SIZE is the amount of free space (number of 256-byte records) starting at the first rec. 



COMMAND (?): LV 
DEVICE ADDRESS: 48 

DEVICE ADDRESS: 0048 

VOLUME FIRST REC. 

FHVL49 1 

VOLl 121 

V0L2 10121 

LIST DIRECTORY INFO? Y 

DEVICE SIZE(RECORDS): 
DIRECTORY REC. NO.: 
DIRECTORY SIZE(RECS): 
UNUSED DIRECTORY BYTES: 
NO. VOLUME ENTRIES: 
MAX. VOLUME ENTRIES: 
FREE SPACE ENTRIES: 
DEVICE HAS FIXED HEADS 

FIXED-HEAD VOLUME IS ALLOCATED 

LIST FREE SPACE CHAIN? Y 



FIRST REC. 
30121 



SIZE 
148952 

























SIZE 














512 ""FH VOL"" 
10000 WRITE VERIFY 
20000 "■"IPL=SEDXNUC * 














^c 




229120 
50049 




















120 

30584 

3 

QCft 














ypo 






1 










CATED 







































COMMAND (?): EN 






J 



^tfcJJ#^ 



UT-418 SC34-0644 



$INITDSK 



O 



$INITDSK - Initialize Direct Access Device Volume Control (continued) 



RD — Rename Diskette VOLl/OWNERID 



Use the RD command to rename a volume label (vOLi) and owner id on a diskette. You can use 
individual diskettes on different diskette devices on the same or a different Series/ 1. Therefore, 
you should assign each a unique name called a volume label. Owner identification indicates who 
owns the contents of the diskette. When you rename the volume label and owner id on a 
diskette, you can no longer access the data under the old name. 

$INITDSK supplies the current volume label and the current owner ID and prompts you for your 
new volume label and owner ID. 

Example: Rename an existing volume label and owner identification. 



COMMAND (?): RD 2 

CURRENT VOLUME LABEL: MYVOL 
ENTER VOLUME LABEL: NEWVOL 

CURRENT OWNER ID: MYDSKT 
ENTER OWNER ID: JWW 

COMMAND (?): 



#*\^ 



If you enter the address of a device other than a diskette, $INITDSK issues the following message: 

ONLY VALID FOR A DISKETTE 
COMMAND (?): 



RV — Rename Volumes 



Use the RV command to rename a volume on a disk or multivolume diskette device. When you 
rename a volume, you can no longer access the data under the old name. You can rename a 
volume with a name that exists on another disk or diskette on the system, but this is not a 
recommended procedure. This should be used only as the last step before you remove your 
diskette. $INITDSK prompts you for the address of the volume you want renamed, the current 
volume name, and the new volume name. 

Example: Rename a volume. 



COMMAND (?): RV 
DEVICE ADDRESS: 48 
VOLUME: SRCLIB 
NEWNAME: SOURCE 
RENAME COMPLETED 



Chapter 4. Utilities UT-4 1 9 



$INITDSK 

$INITDSK - Initialize Direct Access Device Volume Control (continued) 



SV — Split Volume 



Use the SV command to split an existing disk volume or multivolume diskette volume and to 
allocate an additional volume or volumes in the free space at the end of the existing volume. 
With the option of defining additional volumes, the SV command enables you to utilize the entire 
disk. Splitting a volume does not alter existing data. 

To define additional volumes on a disk device, the free space must be contiguous and at the end 
of the volume. If the available free space is fragmented, use $COMPRES to compress the volume 
before using the SV command. If the size of the volume (in records) specified on the sv 
command exceeds the space at the end of the volume, the system issues a message and does not 
allocate the new volume. 

To determine if you have free space on a disk device and if that free space is contiguous or 
fragmented, use either of the following commands: 

• LV command of $initdsk 

• LS command of SDiSKUTl 

You cannot split a volume on a single- volume diskette device. 

Example 1 : Split a volume with sufficient free space at the end of the volume. 



COMMAND (?): SV 

VOLUME: EDX002 

NEW VOLUME: EDX003 

SIZE IN RECORDS: 10000 

EDX002 SPLIT EDX003 ALLOCATED 



COMMAND (?) 






Example 2: Split a volume without sufficient free space at the end of the volume. 



^ 



COMMAND (?): SV 

VOLUME: EDX002 

NEW VOLUME: EDX003 

SIZE IN RECORDS: 10000 

INSUFFICIENT CONTIGUOUS SPACE AT END OF VOLUME 

COMMAND (?): 



\J 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



VD — Verify Device 



Use the VD command to verify that each record in a disk or diskette device is readable. The 
system locates defective records so that you can assign alternates with the $dasdi utility. The 
system issues a message for each defective record it locates. Verifying records on a disk or 
diskette device does not modify the data currently on the device. $INITDSK prompts you for the 
address (in hexadecimal) of the device you want verified. 

Example: Verify a device. 

COMMAND (?): VD 
DEVICE ADDRESS: 48 

229632 RECORDS VERIFIED 



COMMAND (?) 



VV — Verify Volume 



^iM*y' 



Use the W command to verify that each record in a disk or diskette volume is readable. The 
system locates defective records so that you can assign alternates with the $DASDI utility. The 
system issues a message for each defective record it located. Verifying records on a disk or 
diskette volume does not modify the data currently on the volume. 

SINITDSK prompts you for the following information: 

• The name of the volume you want verified. 

• Whether or not you wish to verify the entire volume. 

• The number (in decimal) of the first record you want verified. 

• The total number (in decimal) of records you want verified. 
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$INITDSK - Initialize Direct Access Device Volume Control (continued) 



Example 1 : Verify the first 500 records on a volume. 



COMMAND (?): VV 

VOLUME: EDX002 

VERIFY ENTIRE VOLUME? Y 

500 RECORDS VERIFIED 

COMMAND (?): 



Example 2: Verify a volume with defective records. The system issues a message for each 
defective record it locates. 



COMMAND (?): VV 
VOLUME: EDX002 
VERIFY ENTIRE VOLUME? N 
FIRST RECORD: l 
NUMBER OF RECORDS: 50O 
ERROR AT RECORD 10, DISK 
ERROR AT RECORD 16, DISK 

500 RECORDS VERIFIED 

COMMAND (?): 



/O RETURN CODE= 2 
/O RETURN CODE= 5 



WN — Clear Write Verify 



Use the WN command to remove the write verify set for a specific volume. When you clear write 
verify, edx does not verify that the data written is correct. 



/f~'"^ 



Example: Clear write verify. 



COMMAND: WN 
VOLUME: MYVOL 

COMMAND: 



WV — Set Write Verify 



Use the WV command to set the write verify on for a specific volume. By setting write verify, 
EDX rereads all data that it writes on the data sets on the volume to make sure the data was 
written correctly. You can set write verify off or clear it by using the WN command. 

Example: Set write verify on. 



COMMAND: WV 
VOLUME: MYVOL 



V. 



COMMAND; 



\J 
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$IOTEST - Test Sensor I/O; List Configuration 



$iOTEST determines the complete I/O configuration of a Series/ 1 and tests the operation of 
sensor-based I/O features. $iotest performs the following functions: 

Digital reads and writes (group or subgroup) 

Digital writes with selected time intervals 

External sync Di and DO 

Interrupt processing (normal, special bit, and group) 

Analog reads and writes 

Hardware configuration listing of the Series/ 1 

Device listing (devices supported by the system). 



Invoking $IOTEST 

You invoke $iotest with the $L command or option 9.3 of the session manager. 
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$IOTEST - Test Sensor I/O List Configuration (continued) 

$IOTEST Commands 

To display the $iOTEST commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?):. 



> SL $IOTEST 

LQADINIT $TOTEST 36P , 13: 26:^2, LP=5000, PART=1 

ATTLIST (ALTER) TO STOP LOOPING FUNCTIONS 

COMMAND (?): ? 

EN = END PROGRAM 

DO = DIGITAL OUTPUT 

PD = UP AND DOWN DO WITH TIME 

XO = EXTERNAL SYNC DO 

Dl = DIGITAL INPUT 

XI = EXTERNAL SYNC Dl 

PI = PROCESS INTERRUPT 

SG = SPECIAL PROCESS INTERRUPT GROUP 

SB = SPECIAL PROCESS INTERRUPT BIT 

Al = ANALOG INPUT 

AO = ANALOG OUTPUT 

LD = LIST ALL HARDWARE DEVICES 

LS = LIST CURRENT SUPERVISOR HARDWARE DEVICES 

WS = PUT PROGRAM IN WAIT STATE 

LISTP = DIRECT LISTING TO SSYSPRTR 

LISTT = DIRECT LISTING TO TERMINAL 

COMMAND (?): 



,4" X 



After SIOTEST displays the commands, you are again prompted with command (?):. Then you 
can respond with the command of your choice (for example, DO). Press the attention key and 
enter ALTER to end repetitive functions and to reactivate the program if it enters the wait state. 
For example: 



ENTER MPXR POINT (0-15): 1 
-629 MV, E-3 
-688 MV, E-3 



A I VOLTAGE = 
A I VOLTAGE = 
> ALTER 
COMMAND (?): 



J 



Each command and its explanation is presented in alphabetical order on the following pages. 
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$IOTEST - Test Sensor I/O List Configuration (continued) 



Al — Analog Input 



Use Ai to read analog input. Ai issues a read every 10 milliseconds and only prints the value if it 
is different than that of the last reading. 

Example 1 : Read analog input. 



COMMAND (?): A I 

ENTER DEVICE ADDRESS, (HEX 1-FF): 61 

ENTER RANGE: 1=5V, 2=500MV, 3=200MV, 4=100MV, 

5=50MV, 6=20MV, 7=10MV: 7 
ZERO CORRECTION? N 
ENTER MPXR POINT (0-15): 1 
AI VOLTAGE = -629 MV, E-3 
A I VOLTAGE = -688 MV, E-3 
> ALTER 
COMMAND (?): 



Analog input has a testing facility to convert diagnostic zero or voltage. $lOTEST allows these 
functions if you give the ADC address instead of the multiplexer address. 

Example 2: Convert diagnostic zero or voltage. 



r 



COMMAND (?): A I 

ENTER DEVICE ADDRESS, (HEX 1-FF): 60 

CONVERT DIAGNOSTIC ZERO? Y 

ENTER RANGE: 1=5V, 2=500MV, 3=200MV, ^=100MV, 

5=50MV, 6=20MV, 7=10MV: 1 
A I VOLTAGE = MV, E-0 

> ALTER 

COMMAND (?): At 

ENTER DEVICE ADDRESS, (HEX 1-FF): 60 

CONVERT DIAGNOSTIC ZERO? N 

CONVERTING DIAGNOSTIC VOLTAGE, SHOULD BE k .S +" 0.5 
AI VOLTAGE = ^604 MV, E-0 
AI VOLTAGE = 4602 MV, E-0 

> ALTER 
COMMAND (?): 



COMMAND (?): A I 

ENTER DEVICE ADDRESS, (HEX 1-FF): 60 

CONVERT DIAGNOSTIC ZERO? N 

CONVERTING DIAGNOSTIC VOLTAGE, SHOULD BE 4.5 +- 0.5 
A I VOLTAGE = 4604 MV, E-0 
AI VOLTAGE = 4602 MV, E-0 
> ALTER 
COMMAND (?): 
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$IOTEST - Test Sensor I/O List Configuration (continued) 



Dl — Digital Input 



Use Dl to read digital input. 
Example: Read digital input. 



COMMAND (?): Dl 

ENTER DEVICE ADDRESS, (HEX 1-FF) 

ENTER START BIT (0-15): 

ENTER # OF BITS: 16 

VALUE = A5A5 

VALUE = COFE 

> ALTER 
COMMAND (?): 



50 



DO 



Digital Output 

Use DO to write digital output. 

Example: Write X'A5A5' to DO address 52 



COMMAND (?): DO 

ENTER DEVICE ADDRESS, (HEX 1-FF): 

ENTER START BIT (0-15): 

ENTER # OF BITS: 16 

ENTER DATA (HEX); A5A5 

COMMAND (?): 



52 



An easy way to test the system is to use the Customer Engineer's wrap-back connectors. The 
wrap cable for the IDIO unit connects the first Di address on the card to the first DO address and 
the same for the second Di and DO. These connections include the external sync functions, also. 
Therefore, you can execute two copies of $iotest simultaneously. Similar connectors are 
available for the 4982 Sensor I/O Unit. 



EN — 



End SIOTEST 

Use the en command to end the $iotest utility. 

Example: End $iotest. 

COMMAND (?): EN 

$IOTEST ENDED AT 13:27:29 



\^ 
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$IOTEST - Test Sensor I/O List Configuration (continued) 



LD — List Devices 



Use LD to list the devices attached to your Series/ 1 . ld reads the actual hardware addresses and 
their ids and displays a list of the descriptions. If a device exists but is not powered on, the 
system still displays the description for that device. You can direct the listing to the terminal 
that invoked $iotest or to the $sysprtr by using either the listt or listp command. 

Example: List Series/ 1 hardware configuration. 






COMMAND (?): LD 

ACTUAL SERIES/1 HARDWARE CONFIGURATION 



V 



ADDRESS 


ID 


DEVICE TYPE 








01 


0206 


4974 


PRINTER 








02 


0106 


4964 


DISKETTE UNIT 






03 


OOBA 


4962 


DISK MODEL 


IF 


OR 2F WITH FIXED 


HEADS 


Oi* 


0406 


4979 


DISPLAY STATION 




09 


1006 


SINGLE-LINE BISYNC 






Ik 


040E 


4978 


DISPLAY STATION 




40 


0028 


TIMER FEATURE 








k\ 


0028 


TIMER FEATURE 








kk 


5152 


DDSK 


DISK/DISKETTE 


UNIT 




45 


5212 


4965 


DISKETTE UNIT 






48 


220E 


FOUR 


LINE MLTA 


(2091/2092) 




49 


220E 


FOUR 


LINE MLTA 


(2091/2092) 




4A 


220E 


FOUR 


LINE MLTA 


(2091/2092) 




4B 


220E 


FOUR 


LINE MLTA 


(2091/2092) 




58 


3106 


4963 


DISK SUBSYSTEM 




80 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




81 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




82 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




83 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




84 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




85 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




86 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




87 


0402 


SDLC 


MULTIDROP 


I/O 


ATTACHMENT 




CO 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




CI 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




C2 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




C3 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




C4 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




C5 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




C6 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT ' 




C7 


232E 


ALPA 


MULT 1 PORT 


I/O 


ATTACHMENT 




COMMAND 


(?): 
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$IOTEST - Test Sensor I/O List Configuration (continued) 

LS — List Current Supervisor Hardware Devices 

LS provides a display similar to ld except that it lists only the devices your supervisor supports 
after system ipl; this list can be different from the actual hardware attached to your Series/ 1 . 
You can direct the listing to the terminal that invoked $iOTEST or to the $SYSPRTR by using either 
the LISTT or LISTP command. 

Note: The system will not list communication device cards that you did not install at ipl time. 

Example: List devices supported by supervisor. 



COMMAND (?): LS 

HARDWARE DEVICES SUPPORTED BY THIS SUPERVISOR 

ADDRESS ID DEVICE TYPE 



01 


0206 


k31k PRINTER 


02 


0106 


^96^+ DISKETTE UNIT 


03 


OOBA 


A962 DISK MODEL IF OR 2F WITH FIXED HEADS 


Ik 


O^OE 


4978 DISPLAY STATION 


kk 


5152 


DDSK DISK/DISKETTE UNIT 


80 


0^02 


A98O DISPLAY STATION 


CO 


2003 


5225 PRINTER 


CI 


2001 


5224 PRINTER 


COMMAND 


(?): 





PD — Up and Down Digital Output with Time. 

Use PD to write digital output and specify various time intervals. 

Example: Using DO address 53, set bit 8 on for 10 milliseconds, off for 50 miUiseconds, and 
do this 100 times. 






,.y 



V 



COMMAND (?): pD 

ENTER DEVICE ADDRESS ,(HEX 1-FF): 53 

ENTER START BIT (0-15): 8 

ENTER # OF BITS: 1 

ENTER DATA1 (O-FFFF): i 

ENTER TIME1 IN MS: 10 

ENTER DATA2 (O-FFFF): 

ENTER TIME2 IN MS: 50 

ENTER NUMBER OF TIMES TO LOOP: lOO 

COMMAND (?): 



Note: If you set enter number of times to loop less than or equal to zero, the looping 
continues until you enter the alter command. 



\J 



UT-428 SC34-0644 



o 



'\ 



$IOTEST 

$IOTEST - Test Sensor I/O List Configuration (continued) 

PI — Process Interrupt 

Use PI to test for the occurrence of the process interrupt. 

Example: Test process interrupt for the occurrence of event, 

COMMAND (?): PI 

ENTER DEVICE ADDRESS, (HEX 1-FF): 50 

ENTER BIT (0-15): 3 

PI OCCURRED 

PI OCCURRED 

PI OCCURRED 

> ALTER 

COMMAND (?): 

SB/SG — Special Process Interrupt Bit/Group 

Functionally, the SB and SG commands operate differently within the supervisor, but they print 
basically the same information as normal pi with this utility program. 

XI — External Sync for Digital Input 

Use xo to read digital input using external synchronization. 

Example: Read digital input using external sync. 

COMMAND (?): XI 

ENTER DEVICE ADDRESS, (HEX 1-FF): 51 

ENTER WORD COUNT: 100 

COMMAND (?): 

XO — External Sync for Digital Output 

Use xo to write digital output using external synchronization. 

Example: Write digital output using external sync. 

COMMAND (?): XO 

ENTER DEVICE ADDRESS, (HEX 1-FF): 53 
ENTER WORD COUNT 1-256: 100 
COMMAND (?): 

Note: The system writes data from a buffer within this program that is used for external sync Di 
and DO. Therefore, you can input data by using Dl and output data by using DO. 
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$JOBQUT - Controlling Job Queue Processing 



$JOBQUT controls the job queue processing as a whole. Its commands perform actions on the 
entire job queue processing system rather than on individual jobs. (To submit and control 
individual jobs, see "$SUBMIT - Submit/ Control Jobs in Job Queue Processor" on page 
UT-503.) 

The job queue processing utility enables you to do the following: 

Suspend and resume job queue processing. 

Change the logging terminal. 

Delete all jobs in the queue. 

Display the status of the job queue processing system. 

ReinitiaUze job queue data set. 

Terminate job queue processing. 
Note: Do not use $JOBQ to run interactive programs. 



Invoking $JOBQUT 

You invoke $J0BQUT with the $L command or option 10.1 of the session manager. 

> $L $JOBQUT 

LOADING $JOBQUT 8P, 09:18:62, LP=2300, PART=1 

$J0BQUT - EDX JOB QUEUE CONTROLLER PROGRAM 
ENTER '?' AT ANY TIME FOR HELP 
COMMAND (?): 






After you invoke $JOBQUT, you can enter any of the available commands. If this is the first time 
you enter a command and the job queue processor has not been used previously, $jobqut issues 
the following messages: 



JOB QUEUE PROCESSOR ($JOBQ) MUST BE LOADED TO CONTINUE. LOAD IT (Y/N)? 
PARTITION NUMBER (1-8) OR ENTER FOR ANY: 



Note: We recommend that you always check the status of the job queue processor and job 
queue processing. To check the status of the job queue processor, enter the STQ command in 
response to the command (?): prompt. (See "STQ — Display the Status of Job Queue 
Processing" on page UT-435 for a description of theSTQ command.) 



m J 
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$JOBQUT - Controlling Job Queue Processing (continued) 



The job queue processor, $jobq, starts if you respond Y to the loading prompt. $jobqut 
prompts you for a partition number in which to load $JOBQ. However, you do not need to select 
a partition; just press the enter key, and the supervisor selects a partition large enough to 
contain $JOBQ. $JOBQUT issues the following message: 



L 



JOB QUEUE PROCESSOR LOADED INTO PARTITION x 



J 



where x indicates the partition where the job queue processor is loaded. 

$JOBQUT then issues the following messages indicating its own status, the logging terminal, and if 
there are jobs in the job queue. 



JOB QUEUE PROCESSING HAS BEEN SUSPENDED 
LOGGING TERMINAL IS $SYSPRTR 
THERE ARE NO JOBS IN THE QUEUE 
COMMAND (?): 



$JOBQUT Commands 

To display the $jobqut commands, enter a question mark in response to the prompting message 

COMMAND(?):. 



COMMAND (?): ? 

CLT - CHANGE LOGGING TERMINAL 

DJQ - DELETE JOB QUEUE 

RJQ - RESUME JOB QUEUE PROCESSING 

SJQ - SUSPEND JOB QUEUE PROCESSING 

STQ - DISPLAY STATUS OF JOB QUEUE PROCESSING 

TJQ - TERMINATE JOB QUEUE PROCESSING 

DCH - DETACH $JOBQUT; RESUME-ATTN JOBQUT,END-ATTN ENDJUT 

IJQ - REINITIALIZE JOB QUEUE DATA SET (JOBQDS) 

EN - END SJOBQUT 

COMMAND (?): 



After SJOBQUT displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, rjq). Each command and its 
explanation is presented in alphabetical order on the following pages. 
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$JOBQUT - Controlling Job Queue Processing (continued) 

CLT — Change Logging Terminal 

Use the clt command to change the terminal where the status (the start and end) of jobs is 
displayed. Initially, the job queue logging terminal is $sysprtr. Once you specify the new 
logging terminal, you have the choice of placing the terminal in roll screen mode. If you answer 
Y and turn on roll screen mode, you do not need to press the enter key after the screen is full. 
Output "rolls" off the top of the screen, as new terminal output appears at the bottom of the 
screen. If you answer n, the roll option remains off. $JOBQ stops processing and you need to 
press the enter key each time the screen fills up to display further terminal output. 

Notes: 

1. If you are running a large number of jobs, we recommend turning roll screen mode on, 

2. The roll screen mode option does not apply to printers; however, $jobqut still issues the roll 
mode prompt. Enter Y or N to allow SJOBQUT to continue. 



Example: Change the logging terminal and turn on roll screen mode. 



COMMAND (?): CLT 

THE LOGGING TERMINAL IS NOW $SYSPRTR 

NEW LOGGING TERMINAL NAME OF ' * ' FOR THIS TERMINAL; 

LOGGING TERMINAL CHANGED TO $SYSLOG 

PUT TERMINAL IN ROLL MODE (Y/N)? Y 

.COMMAND (?): 



$SYSLOG 



^-\ 
w ^ 



Log messages are directed to the terminal specified until you change the logging terminal. If you 
terminate and restart job queue processing, log messages are still directed to the terminal last 
specified. If you do not wish to change the logging terminal, press the enter key. 
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$JOBQUT - Controlling Job Queue Processing (continued) 



DCH — Detach $JOBQUT 



Use the dch command to place $jobqut in suspended mode. To resume operation, press the 
attention key and type jobqut 

To end $JOBQUT without resuming operation, press the attention key and enter endjut. 

Example: 

COMMAND {?): DCH 

>JOBQUT 

COMMAND (?): DCH 

>ENDJUT 

$JOBQUT ENDED AT 00:12:03 



DJQ — Delete Job Queue 



Use the DJQ command to delete all jobs currently in the job queue. Once you enter DLQ, 

$ JOBQUT questions whether you want to delete all jobs in the queue. Enter Y to delete all jobs, 

N to cancel the command. 

Example: Delete jobs in job queue. 

COMMAND (?): DJQ 

DELETE ALL JOBS IN THE QUEUE (Y/N)? Y 

JOB QUEUE DATA SET REINITIALIZED 

COMMAND(?): 



EN — End $JOBQUT 

Use the EN command to end the $jobqut utihty. 

Example: End the $jobqut utility. 

COMMAND (?): EN 
$JOBQUT ENDED 



J 
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$JOBQUT - Controlling Job Queue Processing (continued) 

/f \ 



IJQ — Reinitialize Job Queue Data Set (JOBQDS) 



Use the IJQ command to initialize the job queue data set (JOBQDS) if the system detects an error. 
If the job queue data set has an error, $jobqitt issues the following message: 



L 



READ/WRITE ERROR IN JOBQDS 



The logging terminal defaults to $sysprtr Use the clt command to change the logging 
terminal. 

Example: Initialize the job queue data set. 

COMMAND {?): IJQ 

JOB QUEUE DATA SET REINITIALIZED 



RJQ — Resume Job Queue Processing 



Use the RJQ command to resume job queue processing after you have suspended processing with 
the SJQ command. When the job queue processor is initially loaded, it is in suspended mode; use 
the RJQ command to activate it. 

Example: Resume job queue processing. ^ — ^ 

COMMAND (?): RJQ 

JOB QUEUE PROCESSING HAS BEEN RESUMED 

COMMAND (?): 



SJQ — Suspend Job Queue Processing 



Use the SJQ command to suspend job queue processing. All jobs in the job queue are held. 
However, any job that is already executing when you issue the SJQ command will run to 
completion. Jobs submitted for processing after job queue processing is suspended are held in 
the job queue until job queue processing is resumed. 

Example: Suspend job queue processing. 

COMMAND (?): SJQ 

JOB QUEUE PROCESSING HAS BEEN SUSPENDED 

COMMAND (?): 
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$JOBQUT - Controlling Job Queue Processing (continued) 

STQ — Display the Status of Job Queue Processing 

Use the STQ command to display the status of job queue processing on your display terminal. If 
job queue processing is in effect and there are jobs in the job queue, $jobqut issues the 
following messages: 






JOB QUEUE PROCESSING IS IN EFFECT 

LOGGING TERMINAL IS xxxxxxx 

JOB ID I COMMAND DATA SET | PRIORITY | STATUS 



2 OVERNITE.USRVOL 

3 CALCJOB .PAYROL 
k CHECKS .PAYROL 

5 CALCJOB ,EDX002 

6 JOBl ,EDX002 

7 ASMJ0B1 ,EDX002 

NUMBER OF JOBS QUEUED IS 
COMMAND (?): 



iiELD 

WA I T I NG 

EXECUTING 

WAITING 

WAITING 

HELD 



If $JOBQUT detects an error in the job queue data set, it issues the following messages: 



INTERNAL ERROR DETECTED IN JOB QUEUE DATA SET 

THE JOB QUEUE DATA SET MUST BE REINITIALIZED BY 
THE "IJQ" COMMAND IN $JOBQUT 
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$JOBQUT - Controlling Job Queue Processing (continued) 

TJQ — Terminate Job Queue Processing 

Use the TJQ command to end job queue processing. You are asked if the jobs currently in the 
job queue should be deleted. If you respond Y, all jobs are deleted. If you respond N, $JOBQ 
maintains the job queue and the jobs in the queue execute when job queue processing restarts. 
When you terminate job queue processing, any job that is executing will complete. In addition, 
$JOBQ (the job queue processor) and $jobqut end. 

Example: End job queue processing. 

COMMAND {?): TJQ 

TERMINATE JOB QUEUE PROCESSING (Y/N)? Y 

DELETE ALL JOBS IN THE QUEUE (Y/N)? N 

$JOBQ ENDED AT 10:11:62 

JOB QUEUE PROCESSING TERMINATED 

$JOBQUT ENDED 

V y 

Note: You can only terminate job queue processing — and $jobq — with this command. You 
cannot cancel $JOBQ with the $C operator command. If any job in the job queue is executing, 
$JOBQ will not end. 



o 






o 
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$JOBUTIL - Job Stream Processor 

SJOBUTIL is a batch processing capability that you can invoke simultaneously with the execution 
of other programs. This allows you to execute a series of programs sequentially without 
intervention. You include the names of the programs and other information in a collection of 
SJOBUTIL commands that you create with $EDIT1N or $FSEDIT. 

A procedure can invoke another procedure; however, the called procedure cannot invoke 
another procedure. A typical use of SJOBUTIL would be to execute a procedure that causes the 
assembly, Hnk-editing, and formatting of your program. Refer to "Batch Job Example" on page 
UT-455. For additional examples of using $J0BUTIL, see the Operation Guide. 

$JOBUTlL is the main program. It loads and waits for the termination of the following three 
independent programs that actually carry out the majority of the work: 

• $JP1 - opens required data sets 

• $JP2 - interprets all commands 

• $DISKUT3 - executes the al and de commands 

Programs that are capable of receiving parameters in the format used by $J0BUTIL are: 

$COBOL $PASCAL 

$EDXASM $PL/I 

$FORT $PREFIND 

$LINK $S1ASM 

$EDXLINK $UPDATE 
$EDXLIST 



Invoking $JOBUTIL 

You invoke $J0BUTIL with the $L operator command or option 7 of the session manager. 



Setup Procedure 



To create your procedure, use either of the text editing facilities, $EDIT1N or $FSEDIT. If you use 
$EDIT1N to create your procedure, you must use $DISKUT1 to preallocate a disk or diskette data 
set to save the procedure. If you use $FSEDIT to create your procedure, you do not have to 
preallocate a data set. $fsedit automatically creates it for you. 

To run your job, load $JOBUTiL and specify the name of your procedure data set. 

> $L $JOBUTIL 
DSl (NAME, VOLUME): 



Refer to the Operation Guide for instructions on setting up your own jobutil procedure. 
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$JOBUTIL - Job Stream Processor (continued) 

$JOBUTIL Commands 

The SJOBUTIL commands are listed below. Commands must be entered in the following format: 

Command - Start in position 1 . 

Operands - Start in position 10. 

Comment - Start in position 18 or after. You can extend a comment as far as position 71. 
(At least one blank must separate the comment from the operands.) If a command does not 
have any operands, its comments can start in column 10. 

For internal comments, use '*' in position 1 



Command 


Function 


AL 


Allocate data set 


DE 


Delete data set 


DS 


Identify data set 


EJECT 


Start a new page in log listing 


EOJ 


Identify end of job 


EOP 


Identify end of nested procedure 


EXEC 


Load and execute program 


JOB 


Identify job 


JUMP 


Jump to label 


LABEL 


End jump 


LOG 


Log Job Stream Processor Commands 


NOMSG 


Suppress load messages 


FARM 


Identify program parameter 


PAUSE 


Await manual intervention 


PROC 


Identify nested procedure 


PROGRAM 


Identify program 


REMARK 


Remark to operator 


* 


Internal comment 



V:^ 



( 



Jff 
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$JOBUTIL - Job Stream Processor (continued) 



AL — Alloqate Data Set 



Use the al command to identify a data set to be allocated. It returns a $DISKUT3 return code 
that can be used by the jump command. 

Note: An AL statement between a PROGRAM and EXEC statement can cause 
unpredictable results. 

Syntax: 



AL name,volume size type 

Required: name, volume 

size 

type 
Default: none 



Operands Description 

name Defines the data set to be allocated. 

volume Defines the volume on which the data set is to be allocated. 

size Defines the size in blocks of the data set. 

type Defines the type of data set as follows: 

D indicates data (default) 

P indicates program 
Examp/e: 



AL 



TEMPOS, EDXO 03 25 D 
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$JOBUTIL - Job Stream Processor (continued) 

DE — Delete Data Set 

Use the de command to identify a data set to be deleted. 

Note: A de statement between a PROGRAM and exec statement can cause unpredictable 
results. 

Syntax: 



DE 



name,volume 



Required: name,volume 
Default: none 



Operands Description 

name Defines the data set to be deleted. 

volume Defines the volume from which the data set is to be deleted. 

Exampfe: 



DE 



TEMPOS, EDXO 03 
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$JOBUTIL - Job Stream Processor (continued) 



DS — Identify Data Set 

Use the DS command to identify a data set to be opened and accessed by a program. DS 
commands are allowed only between program and exec commands. Up to nine (9) DS 
commands can be specified for a program. 

Syntax: 



DS 




name,vol 


ume 


Required 
Default: 


: name 
volume 


is IPL volume 









Operands Description 

name Defines the data set to be accessed by a program. 

volume Defines the volume that contains the data set to be accessed by a program. 

Example: 



DS 



W0RK1 ,EDX001 
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$JOBUTIL - Job Stream Processor (continued^ 



EJECT — Start New Page in Log Listing 

Use the eject command to print tjie next command in the log listing at the top of a new page. 
If no logging is being done, eject commands are ignored. 

Syntax: 



EJECT 

Required: none 
Default: none 



Operands Description 

None 

Example: 



EJECT 



o 

"<,.:> 



o 
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$JOBUTIL - Job Stream Processor (continued) 



EOJ — End of Job 



Use the EOJ command to indicate the end of the primary procedure. EOJ must be the last 
command in the procedure data set. 

Syntax: 



EOJ 

Required: none 



Operands Description 
None 



BOP — End of Procedure 






Use the eop command to indicate the end of a nested procedure, eop must be the last command 
in the called procedure data set. 

Syntax: 



EOP 
Required: none 



Operands Description 
None 



Chapter 4. Utilities UT-443 



$JOBUTIL 

$JOBUTIL - Job Stream Processor (continued) 



EXEC — Execute Program 

Use the exec command to load and execute the program identified in the preceding PROGRAM 
command. EXEC must have been preceded by a program command. 

Syntax: 



EXEC STORAGE=size 
Required: none 
Default: STORAGE=0 



Operands Description 

STORAGE Specifies the amount of dynamic storage to be allocated to the program to be 

executed. This value overrides the value specified when the program was compiled. 
STORAGE=o (the default) indicates that the dynamic storage specified (if any) 
during compilation should be allocated. 



JOB — Identify Job 



Use the job command, an optional command, to identify the procedure or a collection of 
commands within a procedure data set. When a JOB command is read by $J0BUTIL, a message is 
printed on the terminal with the job name, time started, and date (if timer support is included). 

Syntax: 



.J 



JOB job-name 
Required: job-name 



Operands Description 

job-name Names the current group of commands as a job. 

Example: 



JOB 



TEST1 



\j 
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$JOBUTIL - Job Stream Processor (continued) 

JUMP — Jump to Label 

Use the JUMP to bypass $jobutil commands by testing the completion code of the previously 
executed program. The test compares the program completion code to 'cc'. The commands 
between the jump and the label command with the same label name are ignored if the 
condition tested for is 'true'. An unconditional jump to a label is also permitted. Jumps are 
forward only and are limited to the range of the current procedure; for example, a jump cannot 
occur from one procedure to a label in another procedure. A jump with no label name jumps to 
the next unlabeled label command or to an eoj or an EOP, whichever occurs first. If the system 
encounters an eoj or an eop while searching for a label command, it stops its search for the 
LABEL command and executes the eoj or eop. 

Note: The JUMP and LABEL commands are not permitted in the PAUSE mode. 

Syntax: 



JUMP label-name,op,cc 
Required: none 



g"'\^ 



Operands 

label-name 

op 

cc 

Examples: 



Description 

The name associated with a LABEL command. 

LT, GT, EQ, GE, LE, or NE. 
Program completion code. 



JUMP 
JUMP 
JUMP 



LBL1 ,EQ,20 
LBL2 
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LABEL — Identify Continuation Point 

Use the label command to continue job processing after a related JUMP command is 
encountered. Job processing continues at the label cormnand. The label command is not 
valid in the PAUSE mode 

Syntax: 



LABEL label-name 
Required: none 



Operands 

label-name 

Examples: 



Description 

Defines the command where processing can continue. 



LABEL 
LABEL 



LBL1 



V^' 
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$JOBUTIL - Job Stream Processor (continued) 



LOG — Log Control 



Use the LOG command to indicate whether the $jobutil commands are to be printed as they are 
read and which terminal device is to print them. You can place LOG commands anywhere in the 
procedure data set. If you do not specify a terminal device, the commands are logged on the 
terminal from which you invoked the Job Processor. 

Syntax: 



LOG Operand 

Required: none 
Default: ON 



\ 



Operands Description 

ON Indicates that $JOBUTlL commands are to be printed. 

OFF Indicates that $JOBUTiL commands are not to be printed. 

terminal-name Identifies the terminal device which is to print the job processor commands. 

If you omit this operand, if omitted indicates that the job processor 
commands are to be logged on the terminal from which the job processor 
was called. 



Examples: 



LOG 
LOG 
LOG 
LOG 



ON 

OFF 

$SYSPRTR 
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NOMSG — No Message Logging 



Use the NOMSG command to set LOGMSG=no for the program identified in the preceding 
PROGRAM command. See the LOAD instruction in the Language Reference for the definition of 
LOGMSG. NOMSG is invalid if not preceded by a program command. 

The NOMSG command must be between the PROGRAM and exec commands. 

Syntax: 



NOMSG 
Required: none 



Operands Description 

None 

Example: 



PROGRAM CALCDEMO 
NOMSG 






J 
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$JOBUTIL - Job Stream Processor (continued) 



PARM — Pass Parameter 



Use the farm command to identify the parameters being passed to the program in the preceding 
PROGRAM command, farm must be between the frogram and exec commands. Maximum 
length of the operand on the FARM command is 62 characters. The parameters specified on the 
farm command are passed to the specified program as an EBCDIC character string. In the 
specified program they can be referenced as beginning at the label $farmi and are packed two 
characters per word. The length of the string is determined by the farmn operand of the 
PROGRAM statement in the specified program. For example, parm=31 would cause the 
maximum 62 characters from positions 10-71 of the FARM command to be transferred to the 
specified program starting at the label $FARMl. 

Syntax: 



PARM parameters 
Required: none 



Operands Description 

parameters Defines parameters to be passed to the program. 

Example: 



PARM 



NOLIST,XREF 



PAUSE — Await Manual intervention 



You may code FAUSE as either a command in your $JOBUTiL stream or by typing in FAUSE. as a 
command from your terminal keyboard, jump and LABEL commands are not permitted. 

When a pause command is read, $jobutil prompts you for input. You communicate with the 
processor using the attention key and three pause subcommands. 
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$JOBUTIL - Job Stream Processor (continued) 

PAUSE subcommands are: 

• ABORT - To end $J0BUTIL processing 

• ENTER - To enter $jobutil commands 

• GO - To end the pause mode and read the next command in the procedure data set. 
Syntax: 



/fl IN 



PAUSE 
Required: none 



Operands Description 

None 

Examples: Data set with PAUSE. 



JOB 


PAYROLL 


LOG 


ON 


PROGRAM 


WAGES 


EXEC 




REMARK 


LAST DAY OF MONTH? 


REMARK 


RUN MONTHEND 


PAUSE 




EOJ 





^-J 



Example: In PAUSE mode (terminal output). 



ATTN: GO/ENTER/ABORT 



PAUSE - 

PAUSE 
> ENTER 



ENTER COMMAND PROGRAM 

ENTER OPERAND MONTHEND 

ENTER COMMAND EXEC 
ENTER OPERAND 



o 
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$JOBUTIL - Job Stream Processor (continued) 



PROC — Execute Procedure 



Use the PROC command to pass control to another procedure data set. The operand identifies 
the data set. A PROC command is not allowed in the called procedure data set. You cannot 
place PROC between a program command and an exec command. The completion code of the 
last program executed in the subprocedure will be available for testing by the main procedure. 

Syntax: 



PROC procedure-name,volume 

Required: procedure- name 
Default: volume is IPL volume 






Operands 
procedure -name 
volume 

Examples: 



Description 

Defines the procedure data set to which control is to be passed 

Defines the volume containing the procedure data set to which control is to 
be passed. 



PROC 
PROC 



PAYROLL, EDXO 02 
PAYROLL 
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$JOBUTIL - Job Stream Processor (continued) 

PROGRAM — Identify Program 

Use the PROGRAM command to identify the program to be executed. 

Syntax: 



PROGRAM program-name,volume 

Required: program-name 
Default: volume is IPL volume 



Operands Description 

program-name Defines the name of the program member to be executed. 

volume Defines the name of the volume containing the program member to be 

executed. 



Examples: 



PROGRAM $ DEBUG, EDXO 02 
PROGRAM CHECKS 






y 



o 
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$JOBUTIL - Job Stream Processor (continued) 



REMARK — Display Remark 

Use the remark command to output a message to the operator with log ON or OFF. The 
operand contains the message. The maximum message length is 62 characters. 

Syntax: 



REMARK comment 
Required: none 



Operands Description 

comment Defines the comment to be displayed. 

By including an @ sign in column 9, the screen or printer is advanced one line before remark is 
displayed/printed. 

Example: 



REMARK aiNSERT DISKETTE EDX005 
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* — Comment 



Use an asterisk (*) in position 1 to indicate internal comments in the procedure data set. 
Comments can start in position 2. The internal comment is not printed. 

Syntax: 



* internal connment 
Required: none 



Operands Description 

None 

Example: 



* THIS PROCEDURE IS A TEST CASE 









UT-454 SC34-0644 



$JOBUTIL 



o 



$JOBUTIL - Job Stream Processor (continued) 



Batch Job Example 



The following examples list three procedure data sets. The last two procedures shown are 
invoked by the first. 



Example 1: List data set batch on edxoos. 



">, 



JOB 


BATCH 




LOG 


$SYSPRTR 




REMARK 


THIS JOB SHOULD RUN 


UNINTERRUPTED 


PROGRAM 


JUTEST1 ,EDX003 




NOMSG 






DS 


L0AD1 ,EDX003 




FARM 


F0F4F1F7 




EXEC 






PROGRAM 


JUTEST2,EDX003 




EXEC 






JUMP 


JMP 1 , EQ , - 1 




PROGRAM 


CALCDEMO,EDX002 




EXEC 






LABEL 


JMPI 




PROGRAM 


JUTEST3,EDX003 




PARM 


2 




EXEC 






JUMP 


JMP2,LT,5 




PROGRAM 


$EDIT1N,EDX002 




DS 


EDITWORK,EDX002 




EXEC 






LABEL 


JMP 2 




PROC 


PR0C1 ,EDX003 




PROC 


PROC2,EDX003 




EOJ 










Example 2: List data set PROCi on EDX003. 



LOG 


ON 


REMARK 


PROCI 


PROGRAM 


JUTEST2,EDX003 


EXEC 




EOP 
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Example 3: 


List data set PROC2 on edxoo3. 


REMARK 


PR0C2 


PROGRAM 


JUTEST1 ,EDX003 


DS 


L0AD1 ,EDX003 


FARM 


ENDT 


EXEC 




EOF 





J 



Vjr 
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$LOG - Log Errors into Data Set 



Log Data Set 



$LOG records information concerning I/O errors onto a disk or diskette data set. You can 
display the information recorded on the log data set by using $diskut2. 

To use $LOG you must include the SYSLOG module at system generation. If you want to record 
program check, soft exception, and machine check information, you must also include the 
CIRCBUFF module at system generation. 



Before the system can record I/O errors, you must allocate a log data set to contain the device 
and system information available at the time of the I/O error. The log data set should be at least 
eight records long (data tj^e). The log data set may reside in a disk or diskette volume. The log 
data set contains one 256-byte log entry per record; the first two records are used for control 
information. 



Invoking $LOG 



$LOG can be invoked by EDL programs with the LOAD instruction issued from a terminal. The 
log data set must be defined by the DS= keyword on the LOAD statement. The only required 
parameter is the address of a 4-byte area that contains: 



^\ 





Hexadecimal 
Displacement 


Length 
(Bytes) 


PARM 1 





1 


PARM2 


2 


1 



If PARM1 = "Y" , $LOG will terminate on log data set wrap. If PARM1= " " or "N" , a blank 
or null character, $LOG will not terminate when the log data set wraps. 

If PARM2="Y" , error messages will be displayed on occurrence. If PARM2= " " or "N" , a 
blank or null character, error messages will not be displayed. 



Coding Example 



LOAD $L0G,PARMLIST,DS=(L0GDS,EDX002) 



PARMLIST 



EQU 

DC 

DC 



CL2'N' 
CL2'Y' 



o 
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$LOG - Log Errors into Data Set (continued) 

You may also invoke $log with the $l operator command, the SJOBUTIL utility, or with a load 
instruction issued from a program coded in the Event Driven Language. You must load $LOG 
for. any error logging to occur. If you are loading $LOG from an application program or by using 
a SJOBUTIL procedure, you must pass $LOG a 1-word parameter of zeroes. 

Note: For the remote manager (rmi) to receive error log messages, you must also load either 
the host program (CJUALTHL) or the send program (cjualtsl). 

To activate error logging, load $LOG into any partition. $LOG prompts you for the name of the 
log data set. 



> $L $LOG 
LOGOS (NAME, VOLUME): LOGOS, EDX002 
LOADING $LOG 23P ,01 :02:'»6. LP= 0000, PART=2 



$LOG Commands 



After you load $LOG and the system activates error logging, you can use the attention commands 
provided by $L0G to deactivate, reactivate, or terminate error logging. You can also reinitialize 
the log data set using one of these attention commands. All attention commands can be invoked 
from any terminal assigned to the same storage partition. Messages will always go to the 
terminal from which $LOG was actually loaded. 



> $L $LOG 

LOGOS (NAME, VOLUME): LOGOS, EDX002 
LOAOING $LOG 23P,01 :02:^6, LP= 0000, PART= 2 



XJLJLJUJ.JUJLJt.JUJLJLJ.JLJUJt.JUa.J 



LJLjt.JUXXXJ.XJUJUJLJUJUJ 



^ Jb JL Jk J. X JU J 



$ L G 



UTILITY 



THE FOLLOWING ATTENTION COMMANDS ARE AVAILABLE: 
ATTN/$LOGOFF - TEMPORARILY DEACTIVATE LOGGING 
ATTN/$LOGON - REACTIVATE LOGGING 
ATTN/$LOGINIT - INITIALIZE LOG DATA SET 

REACTIVATE LOGGING 
ATTN/$L06TERM - TERMINATE LOGGING 
ATTN/$LOG - REISSUE COMMAND LIST 
ATTN/$LOGDISP - DISPLAY ERROR MSG ON OCCURRENCE 
ATTN/$LOGTDW - TERMINATE ON DATA SET WRAP 

WARNING: DO NOT CANCEL ($C) "^m | c r»ROGRAM. 



LOGGING ACTIVATED 






Each command and its explanation is presented in alphabetical order on the following page, 
an explanation of the $LOG output, refer to the Problem Determination Guide. 



For 



\J 
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$LOG - Log Errors into Data Set (continued) 

$LOG — Reissue Command List 

Use $LOG to display the attention commands. You can also display the error messages from the 
utility itself that have nothing to do with the errors that $LOG is tracking. 

$LOGDISP — Display Error IVIessages on Occurrence 

Use $LOGDiSP to display error messages as they occur. For example, if your log data set 
becomes full during error logging, $LOG immediately displays an error message. If you don't use 
$LOGDiSP, you must use $LOG to display the errors. 

$L0GINIT — Initialize Log Data Set/Reactivate Logging 

Use $LOGlNiT to clear the log data set. The system then writes a new log control record to 
indicate that the log data set contains no entries. $LOGlNlT also restarts error logging. 

$L0G0FF — Temporarily Deactivate Logging 

Use $LOGOFF to suspend error logging ($LOG remains loaded but but will no longer log errors.) 
$L0G0N — Reactivate Logging 

Use $LOGON to restart error logging. 

$L0GTDW — Terminate on Data Set Wrap 

Use $LOGTDW to end the $LOG utility if the log data set becomes full during error logging. If 
you don't use this command, the the system returns to the third record in the data set and begins 
writing over the existing entries. 

Example: End $LOG when data set wrap occurs; display messages as they occur ($L0GDISP). 



■ $L $LOG LOGOS, EDX002 
•' SLOGTDW 

S_OG WILL TERMINATE ON DATA SET WRAP 
:■ $LOGDISP 

.ERROR MESSAGES WILL BE DISPLAYED ON OCCURRENCE . 

$L0GTERM — Terminate Logging 

Use $LOGTERM to end the error logging utihty ($LOG is deactivated and removed from storage.) 

For more information about I/O error logging, refer to the Problem Determination Guide. For 
information about system generation considerations, see the Installation and System Generation 
Guide. 
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$MEMDISK - Allocate Unmapped Storage as a Disk 

Use $MEMDISK to allocate all or a portion of unmapped storage to use as a "disk." This disk 
resembles a single-volume diskette with the volume name memdsk. You must include the 
STORMGR module at system generation to be able to use unmapped storage and this utility. 

Use the memdsk volume to create temporary work data sets for the$siASM assembler, the 
$EDXASM compiler, and $edxlink. You may also want to place the assembler itself and all the 
overlays on memdsk.. This will decrease assembly time. 

Note: Since MEMDSK is part of the memory system, you will lose the volume in the event of a 
power failure. Use it only for work data sets, programs, and other files that you can recover if a 
power failure does occur. 

Invoking $MEMDISK 

You invoke $memdisk with the $L operator command. 



> $L $MEMDISK 
LOADING $MEMDISK 27P, 00:01 : 5A, LP=2C00, PART=3 

MEMDISK INITIALIZATION UTILITY 

^^HHMMMMIHHHMHIIIIIIIIIIIIIIIIIII^^ 



Once you load $memdisk, you can use memdsk with any of the the other utilities except $DASDI 
and $INITDSK. 



$MEMDISK Commands 



\J^ 



To display the $memdisk commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



COMMAND (?): ? 

IV - LOAD MEMDSK SUPPORT AND INITIALIZE VOLUME 

DV - DELETE MEMDSK FROM SYSTEM 

SL - SET $LOADER TO LOAD FROM MEMDSK 

RL - RESET $LOADER TO LOAD FROM DISK 

SD - SET SYSTEM DEFAULT VOLUME TO MEMDSK 

RD _ RESET SYSTEM DEFAULT VOLUME 

EN - END UTILITY 



Each command and its explanation is presented in alphabetical order on the following pages. 
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$MEMDISK - Allocate Unmapped Storage as a Disk (continued) 

DV — Delete MEMDSK from the System 

Use the DV command to delete MEMDSK from the system and release that part of unmapped 
storage. 

Example: Delete the memdsk volume. 



COMMAND(?): DV 

DELETE MEMDSK? (Y/N) Y 
MEMDSK DELETED 

COMMAND(?): 



EN 



End$MEMDISK 

Use the EN command to end the $memdisk utility. 

Example: End $MEMDISK. 



COMMAND(?): EN 

$MEMDISK ENDED AT 11:18:30 



IV — Load MEMDSK Support and Initialize Disk 



Use the iv command to allocate and initialize memdsk. The system then allocates all the 
resources it needs. 

Example: Allocate and initiaUze memdsk volume. 



COMMAND(?): IV 

SIZE IN RECORDS (0 TO EXIT): 1000 
MAXIMUM NUMBER OF DATA SETS: 20 

MEMDSK ALLOCATED AND INITIALIZED 

COMMAND(?): 



At IPL time, the system gives you the message unmapped STORAGE=xxx (DEC) 2k blocks 
where xxx will be the number in decimal of the available 2K blocks of unmapped storage. You 
can figure your available records by multiplying this number by 8. If you respond to SIZE IN 
RECORDS with a number that is larger than the unmapped storage area that is available, the 
system displays the following messages and then reprompt you. 



^ 



INSUFFICIENT UNMAPPED STORAGE AVAILABLE 
MAXIMUM AVAILABLE SIZE FOR MEMDSK = XXXX 
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$MEMDISK - Allocate Unmapped Storage as a Disk (continued) 

After the system reprompts you for the size in records that you want, it prompts you for with 
MAXIMUM NUMBER OF DATA SETS. If you Specify too many data sets, the system will display the 
following message and then reprompt you. 



I: 



NUMBER OF DATA SETS MUST BE BETWEEN 



XXX 



RL — Reset $LOADER to Load from Disk(ette) 

Use the rl command to reset the loader table to its original contents. 

Example: Reset $loader to load from disk. 

COMMAND(?): rl 

$LOADER WILL NOW BE LOADED FROM DISK 

COMMAND(?); 



RD — Reset System Default Volume 



Use the rd command to reset the system default volume to what it was before you issued the SD 
command. 

Example: Reset system default to EDX002. 



COMMAND(?): rd 

SYSTEM DEFAULT VOLUME SET TO EDX002 

COMMAND{?): 



(f ' 



SD — Set System Default Volume to MEMDSK 

Use the sd command to set the default volume to memdsk. 

Example: Set system default volume to memdsk. 



COMMAND(?): SD 

SYSTEM DEFAULT VOLUME SET TO MEMDSK 

COMMANDS?): 
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$MEMDISK - Allocate Unmapped Storage as a Disk (continued) 

SL — Set $LOADER to Load from MEMDSK 

Use the SL command to cause the system to load $loader from MEMDSK. This allows you to 
load programs much more rapidly since it acts as a resident loader. You must copy $L0ADER to 
MEMDSK (with the $COPYUTl utility) before you use this command. The system saves the 
contents of the loader table in case you wish to restore the table using the RL command. 

Example: Set $loader to load from memdsk. 

COMMAND(?): SL 

$LOADER WILL NOW BE LOADED FROM MEMDSK 

COMMANDC?): 



y 
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$MOVEVOL- Disk Volume Dump/Restore 

With $MOVEVOL you can dump the contents of an Event Driven Executive direct access volume 
to diskette when such a volume spans several diskettes. You can also restore a volume from 
diskette to disk. Thus, $MOVEVOL makes it possible for you to transfer large amounts of data 
from one system to another or to create backup copies of an online data base. 

Diskette Usage 



^>, 



Diskette Contents 



Diskette Format 



The first of the set of diskettes used for the dump function, called the control diskette, records 
control information and the volume directory. The rest of the diskettes store the data portion of 
the volume you are dumping. Control information is recorded on each data diskette to identify 
the diskette contents and to ensure that it contains data related to the dump operation described 
on the control diskette. 



All diskettes must be formatted identically with $dasdi. You can use either single-sided or 
double-sided diskettes; however, all diskettes in a set must be the same type. Each diskette must 
contain a volume label in the standard format. The volume label must be a six-character field in 
which the last three characters are used for sequencing, for example, SAVOOO, SAVOOl, ..., savnnn, 
where nnn is the last diskette used. All diskettes used must have the same three-character 
prefix. The last three characters used for sequencing must start with 000 for the first diskette. 

4966 Diskette Usage Considerations 

If you are using the 4966 diskette magazine unit for your dump/restore operation, you can use 
diskette magazines or an individual diskette slot. If you use an individual diskette slot, then you 
must place all of the subsequent diskettes you mount in the same slot. If you use diskette 
magazines, you must have all of your diskettes in the correct sequence with no empty slots in the 
magazine. The first volume with the suffix 000 must be in slot number 1 of the first magazine. 
You can use either or both of the diskette magazines, A and B. 

Invoking $MOVEVOL 

You invoke $MOVEVOL with the $L operator command or option 3.8 of the session manager. 



o 
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$MOVEVOL- Disk Volume Dump/Restore (continued) 

Data Set Specification 

If you invoke $movevol with the $L operator command, the system prompts you to enter the 
names of the data sets and volumes to be used. 

The following example shows the parameter menu displayed when you invoke $MOVEVOL with 
the session manager. Enter the requested information and press the enter key. 



' $SMM0308: SESSION MANAGER $MOVEVOL PARAMETER INPUT MENU- 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 

DISK ($$EDXLI8, VOLUME) ==> 

DISKETTE (NAME, VOLUME) ==> 



Figure 25. $MOVEVOL parameter input menu 

Dump Procedure 

The following steps are required to dump the contents of a direct access volume onto diskette. 

^) 1 . Set up a control diskette. 

a. Use $INITDSK to: 

1) Initialize the control diskette with a volume label that is suffixed with 000 (for 
example, SAVGOO). 

2) Create a directory containing at least 1 member. 

3) If the diskette will be used to ipl another system, reserve space for a nucleus of the 
appropriate size and write the ipl text. 

b. Use $DISKUT1 to: 

1) Determine the directory size, in records, of the volume to be dumped. 

2) Change volume to the control diskette (for example, SAVOOO) and allocate a control 
data set with the same name as the name of the volume to be dumped. The member 
size of the control data set must be one record larger than the size of the directory 
of the volume being dumped. 
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$MOVEVOL - Disk Volume Dump/Restore (continued) 

c. Use COPYUTI to: 

1) Copy other data sets onto the control diskette. For example, you may require 
$EDXNUC, the transient loader, or a copy of $MOVEVOL. 

Note: The first record in the control data set contains control information and up to 
50 characters of text describing the data being dumped. The remaining space stores 
a copy of the directory of the volume being dumped. 

2. Set up a series of data diskettes. For each data diskette: 

a. Use $INITDSK to: 

1 ) Create a volume label. The volume label of each diskette must have the same 
three-character prefix as the control diskette and a three-character suffix indicating 
the sequence number, for example, SAVOOO, SAVOOl, , SAVNNN. 

2) Create an owner id field. 

3) Allocate a one-member directory (the minimum number of members contained in a 
directory is one). 

b. Use SDISKUTI to: 

1) Allocate a one-record data set named $ control. 

2) Allocate a second data set with the name of the volume to be dumped (for example, 
EDX002). The second data set must use the remaining available space on the diskette 
as follows: 



\ i/ 






Diskette 
type 



Number of 
records at 
128 BPS 



Number of 
records at 
256 BPS 



Number of 
records at 
1024 BPS 



Diskette 1 
Diskette 2 
Diskette 2-D 



946 
1921 



1107 
2217 
3845 



4733 



3. Mount the control diskette and load t^TOVEVOL for execution. 
You must specify two data sets at load uiie: 

DISK The volume on disk to be dumped. Specify $$EDXLlB,volname. 

DISKETTE The control data set on diskette. Specify dsname,volname. 
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$MOVEVOL - Disk Volume Dump/Restore (continued) 

$MOVEVOL asks if you wish to dump from disk to diskette. 

MOVEVOL then determines the number of additional diskettes required to dump the 
referenced volume (disk), informs you of this requirement, and asks if the procedure should 
be continued. Reply N and the operation ends. Reply Y and the control information and 
disk directory are recorded on the control diskette and you are asked to mount a new 
diskette for transfer of the data portion of the volume being dumped. 

4. Each time a diskette is filled, $MOVEVOL requests another diskette. Mount as many data 
diskettes as the system requests. 

Example: Dump operation using a 4966 diskette magazine unit. 



f^^ 






> %L SMOVEVOL 

D I SK(NAME .VOLUME) : $$EDXL I B ,EDX003 
D I SKETTE ( NAME .VOLUME ) : $EDX003 .SAVOOO 

LOADING $MOVEVOL 20P , 10:07 : 52, LP=5200, PART=2 

DUMP VOLUME EDX003 FROM DISK TO DISKETTE? Y 

PROCESSING DISKETTE VOLUME SAVOOO 

ENTER VOLUME IDENTIFICATION (1-50 CHAR.): 09/14/82 

09/1^/82 DUMP OF EDX003 - DATE IS 09/1^/82 

11 MORE DISKETTE(S) REQUIRED, CONTINUE? Y 



PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 
PROCESSING 



DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 



VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 



SAVOOO 
SAV001 
SAV002 
SAV003 
SAVOOO 
SAV005 
SAV006 
SAV007 
SAVOOS 



MOUNT NEXT DISKETTE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAV009 
PROCESSING DISKETTE VOLUME SAV010 

VOLUME DUMP OPERATION COMPLETE 

9200 RECORDS TRANSFERRED 

$MOVEVOL ENDED 10: 10:13 
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$MOVEVOL - Disk Volume Dump/Restore (continued) 



You may enter any text in response to the enter volume identification (1-50 char.): prompt 
when dumping a volume. During the restore procedure, the information you entered here is 
redisplayed. 



Restoration Procedure 

The following steps are required for a restore operation. 

1 . Mount the control diskette and load $MOVEVOL for execution. 

a. Respond as described previously in dump procedure to requests for data sets. 

b. Select the restoration mode by responding N to the query for disk to diskette dump and Y 
to the query for diskette to disk restoration. 

2. Mount data diskettes as requested. 

Example 1 : Restore operation using an individual 4966 diskette magazine slot. The source 
and target volumes are equal in size. 



> $L $MOVEVOL $$EDXLIB,EDX003 $EDX003 .SAVOOO 

LOADING $MOVEV0L 20P, 11:05:05, LP^6300, PART=2 

DUMP VOLUME EDX003 FROM DISK TO DISKETTE? N 

RESTORE VOLUME FROM DISKETTE TO DISK VOLUME EDX003? 
RESTORING DUMP OF EDX003 - DATE IS 09/1^/82 
CONTINUE? Y 

PROCESSING DISKETTE VOLUME SAVOOO 
MOUNT NEXT DISKETTE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAV001 
MOUNT NEXT DISKETTE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAV002 
MOUNT NEXT DISKETTE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAV003 
MOUNT NEXT DISKETTE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAV004 

VOLUME INSTALLED 

3600 RECORDS TRANSFERRED 

$MOVEVOL ENDED 11.10.56 



o 






UT-468 SC34-0644 



$MOVEVOL 



o 



$MOVEVOL - Disk Volume Dump/Restore (continued) 



Example 2: Restore operation using a 4964 diskette unit. The source is smaller in size than 
the receiving volume. 



r 



$L $MOVEVOL 
DISK (NAME, VOLUME): $$EDXL I B ,MACLI B 
D I SKETTE ( NAME , VOLUME ) : $MACL I B , BACOOO 
LOADING $MOVEVOL 20P, 00:26:08, LP= 7000, PART=1 
DUMP VOLUME MACLIB FROM DISK TO DISKETTE? N 

RESTORE VOLUME FROM DISKETTE TO DISK VOLUME MACLIB? 

RESTORING 5719-XX5 V04M00 9/12/82 TO VOLUME MACLIB 

CONTINUE? Y 

SOURCE VOLUME IS SMALLER THAN THE TARGET. CONTINUE? 

COMPRESS THIS VOLUME AFTER INSTALLATION. 

PROCESSING DISKETTE VOLUME BACOOO 

MOUNT NEXT DISKETTE 

REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME BAC001 



V. 
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$MSGUT1 - Message Utility 



f\ 



SMSGUTl formats source messages into a form suitable for use with the message handler. Once 
you have created a source-message data set, $MSGUT1 takes the source messages, converts them 
to either disk or storage-resident format, and saves them in another data set which you specify. 
If you have not allocated this data set previously using $DISKUT1, $MSGUT1 allocates it for you. 
For information on creating a source-message data set, see the Event Driven Executive Language 
Programming Guide. 



Invoking $MSGUT1 



You invoke $MSGUT1 with the $L operator command or option 2.14 of the session manager. 
After you invoke $MSGUT1, it prompts you for a work data set. This work data set must be at 
least as large as the source-message data set. 



> $L $MSGUT1 

WORKFILE (NAME, VOLUME) 



$MSGUT1 Commands 



To display the $MSGUTl commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



COMMAND (?) 



? 



DSK - CONVERT SOURCE TO DISK-RESIDENT FORMAT 

LST * - DIRECT OUTPUT TO A TERMINAL 

PRT - PRINT MESSAGES 

STG - CONVERT SOURCE TO STORAGE-RESIDENT FORMAT 

END - END THE MESSAGE UTILITY 

COMMAND (?): 






After $MSGUT1 displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, PRT). 

Each command and its explanation is presented in alphabetical order on the following pages. 



'\ 
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$MSGUT1 - Message Utility (continued) 

DSK — Convert Source to Disk-Resident Format 

Use the DSK command to convert source messages to the format used for disk-resident 
messages. The DSK command converts a source-message data set to disk-resident format and 
stores the messages in a data set on disk or diskette. Messages converted to disk-resident 
format do not contain variable information or comments. The variable information and 
comments are stripped off, control bytes are inserted at the beginning of each message, and the 
256-byte edx records are restructured into four logical records of 64 bytes for each message. 

DSK prompts you for the name of the source-message data set and the volume on which it 
resides. After you enter this information, DSK prompts for the name of the disk-resident data set 
and the volume where the messages, once converted, are to be stored. 

Example: Convert a source-message data set (USRSRC) on USRVOL and store the messages in 
a disk-resident data set (USRMSG) on the USRVOL. 

COMMAND (?): DSK 

MESSAGE SOURCE DATA SET (NAME, VOLUME): USRSRC .USRVOL 

DISK-RESIDENT DATA SET (NAME, VOLUME): USRMSG, USRVOL 

START OF DISK MESSAGE PROCESSING BEGINS 

DISK-RESIDENT MESSAGES STORED IN USRMSG, USRVOL 

COMMAND (?): 

END — End$MSGUT1 

Use the END command to end SMSGUTi. 

Example: 

COMMAND (?): END 
$MSGUT1 ENDED AT 01:36:04 



o 
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$MSGUT1 - Message Utility (continued) 

LST — Direct Output to a Terminal 

Use the LST command to direct output to a device other than the $sysprtr. Use the LST 
command with the prt, stg, and dsk commands. Unless you change the output device with the 
LST command, all listings requested by the PRT, STG, and DSK commands are directed to the 
$SYSPRTR. If you specify LST*, the listing appears on the terminal where you invoked $MSGUTl. 

Note: When you use the PRT, STG, and DSK options, all error messages are directed to the 
$SYSPRTR unless you specify otherwise. If any errors are detected, the following message is 
displayed: 



^ 



FUNCTION HAS COMPLETED WITH ERRORS, 
CHECK ALL OUTPUT. 






Example: A listing of the messages in edituser on USRVOL is first directed to the mprinter 
and then to the terminal labeled termol 



r. 



COMMAND (?): LST MPRINTER 

COMMAND (?): PRT 

MESSAGE SOURCE DATA SET (NAME .VOLUME) : ED I TUSER.USRVOL 

INCLUDE MSGID (Y/N)?: Y 

ENTER it-CHARACTER MESSAGE 

NUMBER PREFIX (DEFAULT MSG#): PGMA 

MESSAGE SOURCE DATA SET PROCESSING BEGINS 

MESSAGES PRINTED ON MPRINTER 

COMMAND (?): LST TERMOl 

COMMAND (?): PRT 

MESSAGE SOURCE DATA SET (NAME .VOLUME) : ED I TUSER.USRVOL 

INCLUDE MSGID (Y/N)?: Y 

ENTER k CHARACTER MESSAGE 

NUMBER PREFIX (DEFAULT MSG#): PGMA 

MESSAGE SOURCE DATA SET PROCESSING BEGINS 

MESSAGES PRINTED ON TERMOl 

COMMAND (?): 



\^J 



^mu^niJr 
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$MSGUT1 - Message Utility (continued) 



PRT — Print Messages 



Use the PRT command to obtain a hard-copy listing of the messages in a specific source-message 
data set. You have the option of requesting a hsting of the messages in the source-message data 
set with or without msgids (consisting of the four-character component iDand the message 
number). The listing is directed to the $SYSPRTR, If you want to direct the Usting to another 
output device name, use the LST command. 

Example: Request a Usting of the messages and msgids in edituser on USRVOL. 



COMMAND (?): PRT 

MESSAGE SOURCE DATA SET (NAME .VOLUME) : ED ITUSER, USRVOL 

INCLUDE MSGID (Y/N): Y 

ENTER k CHARACTER MESSAGE 

NUMBER PREFIX (DEFAULT MSG#) : PGMA 

MESSAGE SOURCE DATA SET PROCESSING HAS BEGUN 

COMMAND (?): 



Following is a sample of the Usting that appears on $sysprtr. 



PGMAOOl 


aSPOOL 


ACTIVE LIMIT REACHED 


PGMA002 


aSPOOL 


JOB CAPACITY REACHED 


PGMA003 


a SPOOL 


DATA SET FULL 


PGMA004 


ENTER COMMAND: 


PGMA005 


aDALL COMMAND COMPLETED 


PGMA006 


GENERIC JOB NAME PREFIX: 


PGMA007 


aDG COMMAND COMPLETED a 


PGMA008 


aSPOOL 


COMMAND INVALID a 


PGMA009 


aspooL 


COMMAND REJECTED - STOP PENDINCa 
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$MSGUT1 - Message Utility (continued) 

STG — Convert Source-Message to Storage-Resident Format 

Use the STG command to convert a source-message data set to storage-resident format 
(object-like) for systems that do not have a disk or diskette or for better performance. The 
converted data set is stored in a disk data set that must be linked with application programs. 
The name of the disk data set containing the converted data must be the same as the name 
specified in the COMP statement. For a description of the COMP statement, see the Language 
Reference. This data set includes a cross-reference table with the address of the beginning of 
each message number. The address of the cross-reference table is an entry point in the 
storage-resident module and is used by the supervisor to access these messages. 

STG prompts for the source-message data set and the name and volume where the 
storage-resident message module is to be saved. 



Example: Store a source-message data set (MSGiSRC onuSRVOL) in a data set (MSGiOBJ) on 
volume OBJLIB in main storage. 

COMMAND (?): STG 

MESSAGE SOURCE DATA SET (NAME .VOLUME) : MSGISRC ,USRVOL 

STORAGE-RESIDENT MODULE (NAME .VOLUME) : MSGIOBJ ,OBJL I B 

START OF STORAGE MESSAGE PROCESSING 

STORAGE-RESIDENT MODULE STORED IN MSGl OBJ ,OBJL I B 



COMMAND (?): 



V 



J 



D 
vy 



i 
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$PFMAP 

$PFMAP - Identify 31 01 (Block Mode)/4978/4979/4980 Program Function 
Keys 

The $PFMAP utility identifies the program function keys on the 3101 (Block Mode), 4978, 4979 
and 4980 display stations. As you press each key, $pfmap displays the associated system code 
in decimal and hexadecimal. A key's associated system code is the identification returned at 
completion of a wait key instruction or an attnlist interrupt. The hard-copy key is active 
during execution of this program, and the system does not display its code. Press the enter key 
to end $PFMAP. 

Invoking $PFMAP 

You invoke $pfmap with the $L operator command or option 4.6 of the session manager. 

After you load $pfmap, it displays two columns, decimal and hex. For each pf key you press, 
$PFMAP displays the system code in decimal and hexadecimal. 

Example: 

> $L $PFMAP 

LOADING $PFMAP 2P, 00:52:11, LP= 9200, PART=1 

DECIMAL HEX 

2 02 

3 03 
5 05 : 

(Press enter key to end $PFMAP) 
$PFMAP ENDED AT 00:5^:51 
V ■■ ■ ' : - - - -^ ■:- •■■ ■ 

Note: The interrupt key system code displayed in the $PFMAP utility differs from code listed in 
the hardware manual. Coding is always reduced by the value specified for PFl at system 
generation. If you used the default value for the PFl key at system generation, it decreases by 
one, the default value. If another number was specified as the value for PFl at system 
generation, it will decrease by that number. 






Chapter 4. Utilities UT-475 



$PREFIND 

$PREFIND - Prefinding Data Sets and EDL Overlays 



The $PREFIND utility locates the disk, diskette, and tape data sets and EDL overlay programs 
referenced by your program and stores their addresses in the header of your program. After 
$PREFIND has executed, program load time is shortened because the tasks performed by EDX are 
reduced. 

$PREFIND is most effective when it is used to process programs that reference a large number of 
disk, diskette, or tape data sets and edl overlay programs and when these programs must be 
loaded frequently from disk or diskette. We recommend using $prefind if your operating 
environment is relatively "static" or unchanging. 



Program Load Process Overview 



If a program uses data sets or edl overlays programs (ds= and PGMS= parameters in program 
statement), the assembler creates control blocks in the program header for each data set and 
edl overlay program specified. These control blocks contain space for the physical addresses of 
the data sets and edl overlay programs defined. 

All data sets and edl overlay programs required by a program are located and their sizes 
determined each time the program is loaded for execution. Thus, the loaded program executes 
correctly even if the size or location of one or more of the data sets or edl overlay programs it 
uses has changed. 

After you complete the program preparation process with $edxlink or SUPDATE, you can load 
the executable load module to storage. 

When a large number of data sets and/or edl overlay programs are defined, loading can be a 
time-consuming process because edx must search a volume directory for each data set and 
program used. Thus, in a relatively "static" or unchanging environment, such as a production 
application, $PREFIND is useful in reducing the run time of the application. 

$PREFIND allows data sets and edl overlay programs to be located prior to program load time 
and writes physical addresses directly into the program header on disk or diskette. When the 
program is loaded, the information required is already present, so load time is reduced. 

Invoking $PREFIND 

You invoke $prefind with the $L operator command, option 2.11 of the session manager, or the 
job stream processor ($JOBUTIl). 

Prefinding Data Sets and Overlays Using the $L Command 

When you invoke $prefind with the $L operator command, it prompts you for the information it 
requires. 

> $L SPREFIND 

LOADING $PREFIND 27P ,00:06: 15 , LP= 9800, PART=2 

COMMAND (?): 
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$PREFIND - Prefinding Data Sets and EDL Overlays (continued) 



$PREFIND Commands 



To display the commands available under $prefind, enter a question mark (?) in response the 

COMMAND (?): prompt. 

COMMAND (?): ? 

PF - PRELOCATE DATA SETS AND OVERLAYS 
DE - DELETE PREFOUND STATUS 
EN - END THE PROGRAM 

COMMAND (?): 



After $PREFIND displays the commands, it prompts you again with command (?):. Enter the 
command of your choice. 

If you enter either pf or de, $prefind prompts you for the name and volume of the program and 
the numbers (1 through 9) of the data sets and edl overlay programs that are to be located or 
whose prefound status is to be deleted. 

You can enter all of the required information without waiting for the prompting messages. For 
example: 



g^'-\ I COMMAND (?): PF MYPROG ,EDX003 D=(l,2,4,7) P=(1,2,3) J 

The numbers in parentheses correspond to the numbers used in the dsn and pgmn parameters 
on the READ, WRITE, and load Event Driven Language instructions. 

You must always enter the data set and program numbers in the formats D=( , , ) and 

P=( , ). Data set numbers, if present, must always precede edl overlay program numbers. 

The word all can be used in place of the number string within the parenthesis. If you make a 
null response to the prompt for either (but not both) the data set or program numbers, no 
change in the status of the data sets or programs will occur. If you enter a number larger than 
the number of the largest data set/program, this information will be ignored and not cause an 
error. In other words, if you have two data sets Usted in the program header, and you enter 
D=(l,3,5) for the data set numbers' prompt, the first data set will be prefound. The 3 and 5 
will be ignored. 

Enter only those data set or program numbers whose status is to be changed. For example, if a 
program references six data sets and you desire to prelocate the first three and the sixth, enter 
D=(l,2,3,6) when using the PF command. If at a later time you desire to delete the third data 
set from the prefound state, use a de command specifying D=(3). 
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$PREFIND - Prefinding Data Sets and EDL Overlays (continued) 

After performing the PF and de commands described above, data sets 1, 2, and 6 are prefound 
and data sets 3, 4, and 5 are not. The execution of the DE command only affects DS3 and does 
not update the information in the program header concerning DSi, DS2, or DS6. 



o 



In the PROGRAM instruction, you can specify "dsname,??" format. For example, you may have 
coded the PROGRAM instruction as follows: 



TASK1 



PROGRAM START 1 ,DS=(??, (NAME2 ,EDX002) ) , 



In this statement, two data sets are defined. The name of DSi will be specified at load time. 
When the program is loaded, you are prompted for the name of DSi. 

During execution of the de command, you can delete a data set specified in this manner. 
$PREFIND prompts you to enter the name of this data set to be placed back into the program 
header since the original name was overridden during the previous PF command. If you invoke 
the DE command via $jobutil, an error message occurs if the above condition is encountered. 

Any data set or edl overlay program not marked as being in the prefound state is located by 
$LOADER whenever the program is loaded into storage for execution. 

Example 1: Processing multiple programs with prompting messages. 



COMMAND (?): PF 

PGM(NAME, VOLUME): TESTPREF,EDX001 
ENTER DATA SET NUMBERS: D=( 1 ,2,3 ,7 ,9) 
ENTER OVERLAY PGM. NUMBERS: P=(ALL) 

COMMAND COMPLETED 
COMMAND (?): 






Example 2: Processing multiple programs without prompting messages. 



COMMAND (?): PF 
PGM{ NAME, VOLUME): 

COMMAND COMPLETED 
COMMAND (?): EN 



TESTPRE2,EDX001 D=(ALL) P=(ALL) 



. $PREFIND ENDED AT 00:10:59 



J 
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$PiREFIND - Prefinding Data Sets and EDL Overlays (continued) 

Prefinding Data Sets and Overlays Using the Session Manager 

You can use the session manager option menu for program preparation to invoke $prefind. 
Figure 26 shows the parameter input menu displayed when you invoke $prefind with the 
session manager. 



$SMM0211; SESSION MANAGER $PREFIND PARAMETER INPUT MENU 
ENTER/SELECT PARAMETERS PRESS PF3 TO RETURN 



COMMAND 


(P/D): 


'==S=£> . 


D 




PROGRAM 


(NAME, VOLUME) 


====>■, 


TESTPREF 


,EDX001 


DATA SEl 


■ #'S (OR ALL) 




ALL 




PROGRAM 


#'S (OR ALL) 


■===> 


ALL 





Figure 26. $PREFIND parameter input menu 

After you enter the parameters, $prefind executes as if you had invoked it with $jobutil. 

Prefinding Data Sets and Overlays Using $JOBUTIL 

When invoked through $jobutil, $prefind requires the same information as described under 
"Prefinding Data Sets and Overlays Using the $L Command" on page UT-476. You provide 
this information with a parm command having the format shown below. The number of spaces 
between the operands in the parm command may be one or more, as long as the total number of 
characters, including spaces, does not exceed 62. 

Syntax: 



Character 

Position 

1 10 

PARM c progname,volume D=( 



P=( 



o 



Operands Description 

c Either character P for prefind or character D for delete. 

progname The name of the program whose data set and edl overlay program status is to be 
modified. 

volume The volume of the program whose data set and edl overlay program status is to be 

modified. 

, , The string of data set or edl overlay program numbers, or the word all. 
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$PREFIND - Prefinding Data Sets and EDL Overlays (continued) 



When invoked with $jobutil, Sprefind performs either a single prefind or delete function and 
then ends. $PREFIND directs error and/or termination messages to the device defined as 

SSYSFRTR. 



Example: The following is an example of a $jobutil procedure for prefinding data sets and 
EDL overlays. 



LOG 


$SYSPRTR 


JOB 


PREFIND 


PROGRAM 


$PREFIND,EDX001 


NOMSG 




FARM 


D TESTPREF,EDX001 D= (ALL) P=(ALL) 


EXEC 




EOJ 
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$PRT2780 and $PRT3780 



The $PRT2780 and $prt3780 Utilities print the spool records produced by the $rjE2780 and 
$RJE3780 utilities. 



Invoking $PRT2780 and $PRT3780 



You invoke $PRT2780 and $PRT3780 with the $L operator command or session manager options 
8.6 and 8.7, respectively. When either utility is loaded, it prompts you for the name of the spool 
file to be printed. The utility ends when it reaches the end of the spool file. An initial option 
allows you to choose a printer other than $sysprtr if you want. 



> $L $PRT3780 

0S1(NAME,VOLUME): ASMWORK 
LOADING $PRT3780 27P, 00:02:'*^, LP= 8000, PART=2 
PRINT TO $SYSPRTR? (Y OR N): Y 
$PRT3780 ENDED AT 00:03:05 



V 



Spooled data from a /*DR HASP command during a remote job entry session as printed out by 
the $PRT3780 utility is: 



$19.28.14 RM74.RD1 


*** INACTIVE 


$19.28.14 RM74.PR1 


*** INACTIVE 


$19.28.14 RM74.PU1 


*** INACTIVE 


$19.28.14 RM75.RD1 


*** INACTIVE 


$19.28.14 RM75.PR1 


*** INACTIVE 


$19.28.14 RM75.PU1 


*** INACTIVE 
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$PRT2780 and $PRT3780 (continued) 

Sample $RJE Session 

Figure 27 shows a typical remote job entry session using the $rje2780 and $prt2780 utilities. 



> $L $RJE2780 
LOADING $RJE2780 



M2P,00:00:00, LP« 7C00. PART-2 

5F 



ENTER RJE LINE ADDRESS IN HEX 

DIAL HOST 

HOST CONNECTION ESTABLISHED 

> COMMAND 
ENTER COMMAND 
/-SIGNON REMOTEXX 
COMMAND READY TO SEND 
COMMAND SENT 

> PUNCHO 



ENTER PUNCH FILE NAME ( NAME, VOLUME ) : PCH0UT01 ,EDX002 
PUNCH FILE DEFINED 
> SUBMIT 



ENTER SUBMIT FILE NAME ( NAME, VOLUME ) : 
SUBMIT FILE READY TO SEND 
FILE TRANSMISSION STARTED 
FILE TRANSMISSION COMPLETED 

> COMMAND 
ENTER COMMAND 
/*$DA 

COMMAND READY TO SEND 
COMMAND SENT 

> PRINTON 

ENTER PRINTER NAME: PRTR1 
PRTR1 DEFINED AS RJE PRINTER 

> COMMAND 
ENTER COMMAND 
/*$DA 

COMMAND READY TO SEND 

> RESET 

ENTER RESET TYPE (CO,SU,SP,PU) : CO 

RESET COMPLETED 

PUNCHING STARTED 

PUNCHING COMPLETED 

LAST CARD PUNCHED WAS CARD 2 ON RECORD 



RJEJ0BO1,EDX0O2 






34 



Figure 27 (Part 1 of 2). Sample $RJE session 



\j 
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$PRT2780 and $PRT3780 (continued) 



'\ 



r 



SP00L01,EDX002 



SPOOL 

ENTER SPOOL FILE NAME (NAME .VOLUME) 
SPOOL FILE DEFINED 
> SUBMIT RJEJ0B02 

SUBMIT FILE READY TO SEND 
FILE TRANSMISSION STARTED 
FILE TRANSMISSION COMPLETED 

SPOOLING STARTED 



PUNCH DATA BEING RECEIVED - NO PUNCH FILE DEFINED 
ENTER PUNCH FORMAT - S OR 0: S 



ENTER PUNCH FILE NAME {NAME, VOLUME) 

PUNCH FILE DEFINED 

PUNCHING STARTED 

PUNCHING COMPLETED 

LAST CARD PUNCHED WAS CARD 1 ON RECORD 

> ENDSPOOL 

SPOOLING COMPLETED 

> COMMAND 

ENTER COMMAND 
/"SIGNOFF 

COMMAND READY TO SEND 
COMMAND SENT 

$RJE2780 ENDED AT 00:00:00 

> $L $PRT2780 

DS 1 ( NAME .VOLUME ) : SPOOLO 1 ,EDX002 
LOAD I NG $PRT2780 9P ,00 : 00 : 00 , LP= 
PRINT TO $SYSPRTR? (Y OR N): N 
ENTER PRINTER NAME: PRTR1 



PCH0UT02,EDX002 



51 



7C00 



V^$PRT2780 ENDED AT 00:00:00 



F^e 27 (Part 2 of 2). Sample $RJE session 
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$RJE2780 and $RJE3780 

o 

$RJE2780 and $RJE3780 are utilities that simulate an IBM 2780 and 3780, respectively. The term 
"RJE utility" refers to both $rje2780 and $rje3780. 

The $RJE2780 utility simulates an IBM 2780 having the following characteristics and features: 

• Model 2 (Card reader, card punch, and printer) 

• EBCDIC transparency 

• Multiple record transmission 

• End-of -media punch recognition 

• 132-character print line 

• Transparent punch output only 

• No horizontal tab 

• No tape-controlled operations (except channel 1 as new page indicator), including vertical 
tab. 

The $RJE3780 utility simulates an IBM 3780 having the following characteristics and features; 

. 3780 with IBM 3781 Card Punch (^"""] 

• Compression for both input and output 

• Transparent or nontransparent (compressed) punch output. 

Interface to Host RJE Subsystems 

$RJE2780 and $RJE3780 present the same interface to the following System/360 and System/370 
host RJE subsystems: 

• HASP or HASP V4 

• JES2 0rJES3 

• RES 

• VMRSCS 



#^ 
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$RJE2780 and $RJE3780 (continued) 

Invoking $RJE2780 or $RJE3780 

You invoke $rje2780 and $rje3780 with the $l operator command or session manager options 
8.4 and 8.5, respectively. 

When the $RJE utility is first loaded, it checks for the presence of only one BSC line specified in 
the supervisor. If there is only one line, the actual device address of the adapter is used as the 
default line address and the utility issues no prompt. If more than one BSC line has been 
defined, the $RJE utility prompts you for the RJE line address. Subsequent control operations are 
all performed using the $RJE attention commands. Figure 28 lists these commands. 

You can load multiple copies of $RJE using different lines to the host. You can use the spool 
facility to avoid contention for a single printer. Figure 27 on page UT-482 shows a sample $RJE 
session. 



ABORT 


Stops transmission to or from the host 


COMMAND 

■-*■ 


Sends a single card image to the host 


ENDRJE 


Terminates execution of the utility 


ENDSPOOL 


Switches from spooling to direct printing 


PRINTON 


Defines the terminal name used for output 


PUNCHO 


Defines a disk or diskette file for punch output of 




object data 


PUNCHS 


Defines a disk or diskette file for punch output of 




source data 


RESET 


Reset function (use caution) 


SPOOL 


Defines a disk or diskette file for printer output 




and to commence spooling 


SUBMIT 


Sends a data stream to the host 


SUBMITX 


Sends a transparent data stream to the host 



Figure 28. $RJE attention commands 



Chapter 4. Utilities UT-485 



$RJE2780/$RJE3780 



$RJE2780 and $RJE3780 (continued) 

Attention Commands 

Eleven commands are available to perform control operations. 



o 



ABORT 



COMMAND 



ENDRJE 



ENDSPOOL 



PRINTON 



Use the abort command to stop a data transmission that is currently in process. During a 
SUBMIT or SUBMITX operation, normal end-of-file is transmitted to the host following the current 
block. 

During receive operations, EOT is returned instead of a normal acknowledgement, and data then 
continues to be received until the host sends EOT. Depending on the operation of the host rje 
system, this can result in suspension of print or punch output and a pause during which the host 
will receive input. Since the pause for input by the host may be short, you should enter any 
desired commands (for example, submitting another job, cancelling the current output, holding a 
job, or displaying status) before you enter the abort command. 

The ABORT command simulates pressing stop on a 2780 while printing or punching, carriage 
STOP on a 3780 printer while printing, or stop on a 3781 punch while punching. 



Use the command command to send a single card image record to the host. The most common 
use of this capability is to send control commands and information requests to the host. For 
example, this command should be used to terminate BSC job stream processing on JES2 and JES3 
host systems by sending the signoff control statement, /*SlGNOFF. 

After entering COMMAND, you are asked to enter the actual command to be sent to the host. 
For a list of vaUd commands and requests, refer to the operator reference manuals pertaining to 
your system. 



Use the endrje command to end the $rje utility program. 



Use the endspool command to end the spooling of printer output (see spool). If a print data 
stream is being received and spooled when you enter this command, spooling continues until the 
end of the data stream. Subsequent print data streams will then be printed on the defined 
printer. 



Use the printon command to define the name of the terminal to be used for print output. If 
you do not specify this, $SYSPRTR is assumed. If a print data stream is being received and 
printed when you enter this command, the print data stream continues to print on the same 
device until the end of the data stream is reached. Subsequent print data streams will then be 
printed on the newly defined printer. 



f^, 
l^y 
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$RJE2780 and $RJE3780 (continued) 



PUNCHSandPUNCHO 



Use the punchs and puncho commands to define the disk or diskette file to receive punch data 
from the host. Card image punch data streams are written to disk in two different formats: 
source (s) or object (o). Source format produces two 80-byte card image records per 256-byte 
disk record with the second card starting at byte location 129. Object format produces three 
80-byte contiguous card image records per 256-byte disk record with the last 16 bytes set to 
hexadecimal zeros. The punch specification is automatically reset at the completion of each 
punch data stream so that multiple punch data streams can be separated into different output 
data sets by issuing another punchs or puncho command. 



> 



RESET 



When you enter punchs or puncho, the $rje utility prompts for the name and volume of the 
file to be used for punch output. If you do not specify volume, the ipl volume is assumed. The 
file name and volume can also be specified as part of the punchs or puncho command, for 
example: 



I: 



PUNCHS PUNCHOUT.EDXOOI 



$RJE examines the first cards received from the host and disregards those containing a X'6A' in 
columns 1, 10, and 11 (indicating a HASP punch header card). You must modify $RJE to purge 
other than HASP punch header cards. 



Use the reset command to reset functions that have not started operation in $rje (for example, 
buffered command images that have not yet been sent to the host and submit files that have not 
yet started transmission). Use reset with caution: if you issue RESET while a function is in 
process or if you overlap a function initiation sequence, you may get unpredictable results. 
RESET conditionally prompts you with the following: 



ENTER RESET TYPE (CO.SU.SP ,PU) : 

CO - COMMAND FUNCTION 

SU - SUBMIT(X) FUNCTION 

SP - SPOOL FUNCTION 

PU - PUNCH(S OR 0) FUNCTION 



J 
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$RJE2780 and $RJE3780 (continued) 

SPOOL 



Use the SPOOL command to define the disk or diskette file to receive printer data from the host. 
If you do not define a file, $RJE prints received data directly to the printer. Once specified, all 
printer output is spooled until you issue an endspool command The $prt2780 or $prT3780 
utility is used to print the contents of a spool file produced by $rje2780 or $RJE3780, respectively. 

Upon entering the SPOOL command, you are prompted for the name and volume of the disk or 
diskette file to be used for printer output. If you do not specify a volume, the ipl volume is 
assumed. The space allocated to this file must be at least equal in size (256-byte records) to the 
number of print lines to be spooled, and there must be an even number of records in the spool 
file. Once the spool file is full, the output reverts to the defined printer. You can enter the 
spool file name and volume with the SPOOL command, for example: 



I: 



SPOOL SPOOLFLE.WRKLIB 



SUBMIT and SUBMITX 



Use the SUBMIT and submitx commands to define and send, respectively, a data stream or 
transparent data stream to the host. You can send multiple disk or diskette files using the 
/♦CONCAT statement in the data stream itself. The files must be in the same format as that 
produced by the $editin and $fsedit utility programs (for example, two 80-byte card image 
records per 256-byte disk or diskette record with the second card beginning at byte location 
129). 

Two command statements within the data stream are recognized by RJE and are not transmitted 
to the host: 

/*end, which signifies the end of the data stream to be sent; and 

/♦CONCAT filename,volume, which signifies that the data stream is to be continued using the 
file specified. If you do not specify a volume, the ipl volume is assumed. You can 
concatenate any number of files into one data stream, but the /*C0NCAT statement can only 
be used once in each file. It should be the last statement since the utility uses the statement 
to open the next file and never returns to the previous or original file. 

When you enter a submit or submitx command, you are prompted for the name and volume of 
the file to be sent to the host. If you do not specify a volume, the ipl volume is assumed. You 
can also enter the submit f Ue name and volume with the submit or submitx command, for 
example: 



\k M 



k 



SUBMITX MYJOB.WRKLIB 



\J 
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$SPLUT1 - Spool Utility 

You can use $SPLUTl to change the spooling capacity parameters and specify restart of the 
spooling facility under specific circumstances. 

$SPLUT1 Operations 

You can use the spool utility to perform the following operations: 

1 . Change any of the following spooling capacity parameters. 
Command Function 

CD Change the devices designated as spool devices and specify spool writer autostart. 

DS Change the spool data set to be used. 

GS Change the spool data set group size. 

MA Change the maximum number of active spool jobs. 

MJ Change the total number of spool jobs allowable in the system at any point in 

time. 

SO Change the separator page option. 

Figure 29 on page UT-491 lists the default parameters shipped with the spooling facility. 

2. Specify that spoohng is to be restarted using a specified, previously used spool data set. 
Use spool RS command to: 

• Restart spooling to retrieve the output spooled up to the last checkpoint in the event of a 
system failure. Checkpoint data is written to the spool data set each time a group of 
records is allocated to a spool job, each time a spool job becomes ready or is deleted, 
and each time a $s operator command is processed. For an explanation of the $S 
operator command, see "$S - Control Spooled Program Output" on page UT-19. 

• Restart spooling as a normal procedure after invoking the spool facility - whether or not 
any previously spooled data remains in the spool data set used for the restart. 

• Copy a spool data set to diskette and transfer to another machine and thus make spooled 
output available across systems. 

Note: Once the spool restart is specified, restart remains in effect for all subsequent spool 
sessions until reset with $SPLUTl. 
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$SPLUT1 - Spool Utility (continued) 



3. Use the RS command to specify that spooling is to be cold-started, initializing the specified 
spool data set. A cold start should be specified: 

• The first time a new spool data set is used; 

• To delete any jobs left over from a previous spool session. 

Set the restart mode on (y) to start spooling using a previously used spool data set. Use 
restart mode to: 

• Ensure that any data left from a previous session is not lost. 

• Restart spooling to retrieve the output spooling up to the last checkpoint before a system 
failure. Checkpoint data is written to the spool data set each time a group of records is 
allocated to a spool job, each time a spool job becomes ready or is deleted, and each 
time a $s operating command is processed. 

• Transfer a spool data set on diskette from another Series/ 1 . 
Notes: 

a. The specified restart mode (y/n) remains in effect for all subsequent spool sessions. 

b. Restart mode must be set to off (n) before you change any spooling capacity 
parameters. 

c. You cannot set restart mode to on (y) during the $spluti session in which you 
change any spooling capacity parameters (CD, DS, GS, MA, MJ, and SO commands). 

d. The changes take effect in the next spooling session. 

• Specify the termination of $spluti. 

CA Cancel the utility and ignore the changes. 

EN End the utility and record the changes. 
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$SPLUT1 - Spoof Utility (continued) 



Notes: 

1 . Items 1 and 2 are mutually exclusive in a single utility session. On any single invocation of 
the spool utility, you can do one or the other of these, but not both. That is, if you change 
the spooling support parameters, you cannot specify a spool restart; if you specify a spool 
restart, you cannot change the spooling capacity parameters. 

2. Restart mode must be reset before you can use any of the spool capacity change parameters. 

3. The changes do not affect the current spooling session. They take effect in the next 
spooling session. 

4. With the shipped system, the SSYSPRTR writer is automatically started at the start of a spool 
session. 



PARAMETER 


DEFAULT 


Spool data set name (DSNAME) 


SPOOL 


Spool data set volume (VOLUME) 


EDX003 


Maximum allowable spool jobs (MAXJOBS) 


10 


Maximum active spool jobs (MAXACTV) 


4 


Restart (RESTRT) 


N 


Spool data set group size (GRPSZ) 


100 


Spool data set groups (GRPS) 


10 


Separator page option (SEP) 


Y 


Designated spool devices (DEVICES) 


$SYSPRTR 



Figure 29. Spooling Defaults 



Invoking $SPLUT1 



You invoke $SPLUT1 with the $L operator command or option 4.7 of the session manager. You 
can load $spluti into any partition whether or not spoohng is active. 



> $L $SPLUT1 
LOADING $SPLUT1 



30P,01:00:16, LP= 0000, PART=1 



EDX SPOOL UTILITY " 

CHANGES EFFECTIVE THE NEXT TIME $SPOOL IS LOADED " 



DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP— DEVICES-AUTO-FORM 
SPOOL EDX003 10 A N 10 100 Y $SYSPRTR Y 
COMMANDC?): 
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$SPLUT1 - Spool Utility (continued) 



$SPLUT1 Commands 



To display the SSPLUTi commands, enter a question mark in response to the command (?): 
prompt. 



r 



COMMAND(?): ? 

DS - CHANGE DATA SET NAME 

MJ - CHANGE MAX JOBS 

MA - CHANGE MAX ACTIVE JOBS 

RS - RESTART 

CD - CHANGE SPOOL DEVICE(S) (10 MAXIMUM) 

GS - CHANGE SPOOL DATA SET GROUPS I ZE 

SO - SET SEPARATOR PAGE OPTION 

CA - CANCEL UTILITY (CHANGES IGNORED) 

EN - END UTILITY (CHANGES ACCEPTED) 

COMMAND(?): 



After $SPLUT1 displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, DS). 



Spool Capacity Change Examples 



Example - Change Spool Support Parameters 

The following example shows how to: 

Change the spool data set to spooltmp,edxoo3. 

Increase the total number of spool jobs allowed in the system at any point in time to 14. 

Increase the maximum number of active spool jobs to 10. 

Designate the devices mptr and lptr as well as $sysprtr as spool devices. 

Specify automatic writer start for $sysprtr with forms code FM35. 

Specify no automatic writer start for lptr and mptr. 

Change the spool data set allocation (groupsize) to 20 records per group. 

Change separator option to no (do not write separator page between jobs). 



W jj^ 



o 
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$SPLUT1 - Spool Utility (continued) 









> $L $SPLUT1 
LOADING $SPLUT1 



30P,01:00:16, LP= 0000, PART=1 



** EDX SPOOL UTILITY *' 

** CHANGES EFFECTIVE THE NEXT TIME $SPOOL IS LOADED *' 



DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 

SPOOL EDX003 10 4 N 14 100 Y 

COMMAND(?): DS 

ENTER(NAME, VOLUME): SPOOLTMP ,EDX003 

DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 



SPOOLTMP EDX003 



10 



N 



14 100 Y 



COMMAND(?): MJ 

MAX JOBS: l4 

DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 



14 



N 



14 100 Y 



SPOOLTMP EDX003 

COMMAND(?): MA 

MAX ACTIVE JOBS: 6 

DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 

SPOOLTMP EDX003 l4 6 N l4 100 Y 

COMMAND(?): CD 

DEVICE NAME (ENTER BLANK TO END): $SYSPRTR 

WRITER AUTOSTART ? (Y/N): Y 

ENTER FORMS CODE: FM35" 

DEVICE NAME (ENTER BLANK TO END) 

WRITER AUTOSTART ? (Y/N): N 

DEVICE NAME (ENTER BLANK TO END) 

WRITER AUTOSTART ? (Y/N): N 

DEVICE NAME (ENTER BLANK TO END) 

DSNAME-— VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 



•DEVICES-AUTO-FORM 
$SYSPRTR Y 

-DEVICES-AUTO-FORM 
$SYSPRTR Y 

•DEVICES-AUTO-FORM 
$SYSPRTR Y 



•DEVICES-AUTO-FORM 
$SYSPRTR Y 



MPTR 



LPTR 



SPOOLTMP EDX003 



14 



N 



14 100 Y 



COMMAND(?): GS 

PHYSICAL RECORDS PER GROUP (1-255): 20 

DSNAME— VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP- 



SPOOLTMP EDX003 



14 



N 



14 



20 Y 



-DEVICES-AUTO-FORM 

$SYSPRTR Y FM35 
MPTR N 
LPTR N 

-DEVICES-AUTO-FORM 

$SYSPRTR Y FM35 
MPTR N 
LPTR N 



COMMAND(?): SO 

SET SEPARATOR PAGE OPTION (Y/N NOW IS Y): N 

DSNAME-—VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP — DEVICES-AUTO-FORM 



SPOOLTMP EDX003 



COMMAND(?): EN 



14 



N 



14 



20 N 



$SYSPRTR Y 
MPTR N 
LPTR N 



FM35 
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$SPLUT1 - Spool Utility (continued) 



Spool Start Type Examples 



Example 1: Specify spool restart to current data set. This example shows how to specify that 
a spool restart is to be done using the same spool data set used in the last spooling session 

(SPOOL,EDX003). 



> $L $SPLUT1 
LOADING $SPLUT1 



30P,00:10:16, LP= 0000, PART=1 



** EDX SPOOL UTILITY ** 

** CHANGES EFFECTIVE THE NEXT TIME $SPOOL IS LOADED ** 



DSNAME—VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP — DEVICES-AUTO-FORM 

SPOOL EDX003 I't 6 N l^* 100 Y $SYSPRTR Y FM35 

MPTR N 
LPTR N 

COMMAND(?): RS 

RESTART Y/N (?): Y 

ALL PREVIOUS CHANGES IGNORED 

RESTART TO SPOOL, EDX003? Y 

NO FURTHER CHANGES ALLOWED 

DSNAME—VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP— DEVICES-AUTO-FORM 

SPOOL EDX003 14 6 Y 14 100 Y $SYSPRTR Y FM35 

MPTR N 

LPTR N 



{ ) 



COMMAND(?): EN 
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$SPLUT1 - Spool Utility (continued) 



Example 2: Specify spool restart using data set spool i. This example shows how to specify 
that a spool restart is to be done using a different spool data set than that used in the last 
spooling session. 



r 



> $L $SPLUT1 
LOADING $SPLUT1 



30P,01:00:16, LP= 0000, PART=2 



** EDX SPOOL UTILITY ** 

** CHANGES EFFECTIVE THE NEXT TIME $SPOOL IS LOADED ** 



0SNAME—VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP--DEV ICES-AUTO-FORM 



SPOOL 



EDX003 



lA 



]h 100 Y $SYSPRTR Y FM35 
MPTR N 
LPTR N 



COMMAND(?): rs 

RESTART Y/N (?): y 

ALL PREVIOUS CHANGES IGNORED 

RESTART TO SPOOL ,EDX003? N 

ENTER (NAME, VOLUME): SPOOL! ,EDX003 

NO FURTHER CHANGES ALLOWED 

DSNAME — VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP--DEV ICES-AUTO-FORM 
10 4 Y 15 100 Y $SYSPRTR Y FM35 



V 



SPOOL 1 EDX003 
COMMAND(?): EN 



Note: MAXJOBS, maxactv, grps, and devices reflect the configuration of the spool data used 
in the last spooling session using that data set. 
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$SPLUT1 - Spool Utility (continued) 



Example 3: Specify spool cold start. This example shows how to specify that spooling is to be 
cold-started. 



> $L $SPLUT1 
LOADING $SPLUT1 



33P,01:00:16, LP= 0000. PART=2 



'•* EDX SPOOL UTILITY 

''* CHANGES EFFECTIVE THE NEXT TIME $SPOOL IS LOADED 



DSNAME---VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP--DEV ICES-AUTO-FORM 

SPOOL SP00L2 ]k 6 Y 1^ TOO Y $SYSPRTR Y FM35 

MPTR N 
LPTR N 

COMMAND(?): RS 
RESTART Y/N ?N 

DSNAME-—VOLUME-MAXJOBS-MAXACTV-RESTRT-GRPS-GRPSZ-SEP--DEV ICES-AUTO-FORM 

SPOOL SP00L2 14 6 N 14 100 N $SYSPRTR Y FM35 

MPTR N 

LPTR N 



V 



C0MMAND{?): EN 



\ 
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$STGUT1 - Free Up Nonprogram Areas of Storage 



$STGUT1 releases any areas of storage, within a specific partition, that are not assigned currently 
to application programs. It also prints out the segmentation registers of the partition you are in 
currently or the number of overlay segments in unmapped storage. 



Invoking $STGUT1 



Invoke $STGUT1 with the $l operator command. The session manager does not support this 
utility. 



► $L $STGUT1 
$$TGUT1 - FREE STORAGE UTILITY 

LOADING $STGUT1 



9P, 00: 00: 00, LP= 0000, PART= 2 



^ 



COMMAND (?) 



$STGUT1 Commands 






To display the $stguti commands on your terminal, enter a question mark in response to the 
COMMAND (?): prompt. 

COMMAND (?): 7 

FR - FREE UP STORAGE 

DS - LIST STORAGE SEGMENTATION REGISTERS 

MX - MONITOR SYSTEM CONTROL BLOCKS 

(-CA- WILL CANCEL) 
UN -LIST UNMAPPED STORAGE INFORMATION 
EN - END PROGRAM 
COMMAND (?): 






After $STGUT1 displays the commands, you are prompted with COMMAND (?): again. Then you 
can respond with the command of your choice (for example, fr). 

Each command and its explanation is presented in alphabetical order on the following pages. 
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$STGUT1 - Free Up Nonprogram Areas of Storage (continued) 

DS — List Storage Segmentation Registers 

Use the DS command to list the storage segmentation registers for the current partition. If you 
wish to list the segmentation registers of another partition, use the $CP operator command to 
change partitions. 

Example: List segmentation registers. 



^t_^ 



/ 

' COMMAND (?) 



BLOCK 
0000 
0800 
1000 
1800 
2000 



D800 
EOOO 
E800 
FOOO 
F800 



DS 



ADSO ADS1 ADS2 ADS3 ADSA 

0004 OlOA 020^1 0304 0000 

OOOC OlOC 020C 030C 0000 

0014 0114 0214 0314 0000 

001C one 021C 031c 0000 

0024 0124 0224 0324 0000 



ADS5 ADS6 ADS7 
0000 0000 0000 
0000 0000 0000 
0000 0000 0000 
0000 0000 0000 
0000 0000 0000 



OODC 010c 02DC 03DC 0000 0000 0000 0000 
00E4 01E4 02E4 03E4 0000 0000 0000 0000 
OOEC OlEC 02EC 03EC 0000 0000 0000 0000 
00F4 01F4 02F4 03F4 0000 0000 0000 0000 
OOFC OlFC 02FC 03FC 0000 0000 0000 0000 



COMMAND (?) 



EN — End Program 



J 



Use the en command to end the $stguti utility. 
Example: 



COMMAND (?): EN 
$STGUT1 ENDED AT 02: 18:31 
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$STGUT1 - Free Up Nonprogram Areas of Storage (continued) 



FR — Free Up Storage 






Use the FR command to release storage that is not being used by appUcation programs. $STGUTl 
prompts you for the partition number and location (load point) of the storage you want to 
release. If the area is assigned to a program currently, $STGUTl issues a message and does not 
release the area. 

Example 1 : Free up storage in partition 4 at load point 0. 

COMMAND (?): FR 
PARTITION = k 
LOAD POINT = 

STORAGE RELEASED 



Example 2: Attempt to free up storage beginning at load point in partition 4 that is assigned 
to a program currently. 

COMMAND (?): FR 
PARTITION = h 
LOAD POINT = 

PROGRAM AREA-NOT RELEASED 

V 

In this example, the storage area was assigned to a program or there was no storage to be 
released at the load point (address) you specified. 



MX — Monitor System Control Blocks 



Use the MX command to monitor the buffer used to track the number of interrupts that are 
received by the supervisor and the cross partition stack used by the supervisor when branching 
between partition one and supervisor code located in other partitions. The interrupt buffer and 
cross partition stack are defined with the system definition station. The interrupt buffer iabuf 
is defined with the iabuf= operand and defaults to 20 interrupts. The cross partition stack 
XPSSTK is defined with the XPSSTK= operand and defaults to 20 entries. You can Ust the buffer 
and stack information on your terminal or write it out to disk or diskette. 

To hst the information on your terminal, use the > Di command under the MX command. 
$STGUT1 displays the most recent size of the iabuf and the XPSSTK, the maximum number of 
entries used to date (max used entries), and the number of entries being used currently. 

To write the information to a disk or diskette, $STGUTl prompts you for a data set name and 
volume. If the specified data set has already been used to store buffer and stack information, 
$STGUT1 first reads the information contained in it and then automatically updates this 
information periodically. If the specified data set did not exist previously, STGUTl creates and 
updates the information automatically. The data set is updated whenever the attention Di (> Di) 
command is used to display the information on the terminal. It is not necessary to enter the (> 
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$STGUT1 - Free Up Nonprogram Areas of Storage (continued) 

Di) command after using the MX) command for the first time. Information appears automatically 
at that time only. 



Use the MX cormnand to obtain other types of information, such as SCBs and/or static and 
dynamic segmentation register information. 

It is recommended that you check the iabuf and xpsstk periodically to ensure that they are 
large enough for your system to continue executing. If the maximum used entries for either the 
IABUF or the xpsstk is reaching the specified size, you should redefine the sizes on the system 
definition statement and regenerate your system. 



Example 1 : List the XPS stack information on the terminal and cancel buffer and stack 
monitoring. 



/ 

COMMAND (?): 



MX 



ATTN 'CA' CANCELS MONITORING 

ATTN 'DI' LISTS SYSTEM INFORMATION ON TERMINAL 

WRITE XPS STACK INFO TO OISK(ETTE)? N 



IABUF SIZE = 20; 
XPSSTK SIZE = 20; 
> CA 

MONITORING CANCELLED 

COMMAND (?): 



MAX USED ENTRIES = 
MAX USED ENTRIES = 



0; 
2; 



CURRENT ENTRIES = 
CURRENT ENTRIES = 



IABUF SIZE 
XPSSTK SIZE 

> DI 

IABUF SIZE 
XPSSTK SIZE 

> CA 



20; 
20; 

20; 
20; 



MAX USED ENTRIES = 0; 

MAX USED ENTRIES = 2; 

MAX USED ENTRIES = 0; 

MAX USED ENTRIES = 2; 



CURRENT ENTRIES = 

CURRENT ENTRIES = 1 

CURRENT ENTRIES - 

CURRENT ENTRIES = 1 



MONITORING CANCELLED 



. COMMAND (?) 



Example 2: Write XPS stack information to diskette and display it on the terminal. 



COMMAND (?): MX 

ATTN 'CA' CANCELS MONITORING 

ATTN 'DI' LISTS SYSTEM INFORMATION ON TERMINAL 

WRITE SYSTEM INFORMATION TO DISK(ETTE)? Y 

ENTER OUTPUT DATA SET (NAME .VOLUME) : STACK, EDX^O 



J 



4' X 



\J 
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$STGUT1 - Free Up Nonprogram Areas of Storage (continued) 



UN — List Unmapped Storage Information 



Use the UN command to list the number of overlay segments residing in unmapped storage for a 
specific program. 



COMMAND (?): UN 
PROGRAM NAME: EDXLINK 



If the program you specify is not active currently, $STGUTl issues the following message: 



I 



PROGRAM EDXLINK NOT FOUND 



If the program specified does not require any overlay segments in unmapped storage or no 
overlay segments have been referenced, SSTGUTI issues the following message: 

I PROGRAM= EDXLINK PART= 2 
I NO STORAGE BLOCKS FOUND 



If the program specified does require overlay segments in unmapped storage, $STGUTl issues the 
following messages (an explanation of the numbered items follows the example): 



0\^ 



COMMAND (?): UN EDXLINK 

PROGRAM= EDXLINK PART= 3 

UNMAPPED STORAGE BLOCK # 1 

OVERLAY MANAGER STORAGE BLOCK 

NUMBER OF UNMAPPED STORAGE AREAS REOUESTED= 5 

NUMBER OF STORAGE-RESIDENT AREAS OBTAINED= 5 

ADDRESS OF MAPPED AREA= 6000 PART= 3 

COMMAND (?): 
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$STGUT1 - Free Up Nonprogram Areas of Storage (continued) 

Q The name of the program requiring overlay segments in unmapped storage. 

Q The number of the storage block that is being described. (If more than one control block is 
described, information about each control is displayed.) 

Q The overlay manager has requested the storage block area. The overlay manager is 
automatically invoked by the $edxlink unmapcnt control statement. 

Q The number of unmapped storage areas requested. 

Q The number of unmapped storage areas actually obtained. If the number is less than 

requested, the program will still execute with the areas not placed in unmapped storage bein^ 
referenced off the disk. 

H The address and partition of the mapped area. 






'~>\ 
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$SUBMIT - Submit/Control Jobs in Job Queue Processor 



The $SUBMIT utility performs several functions to submit jobs ($J0BUTIL command data sets) 
and control processing of those jobs by the job queue processor. $submit enables you to: 

Submit a job for execution. 

Submit and hold a job. 

Hold a job waiting for execution. 

Release a held job for execution. 

Delete a job. 

Display the status of the job queue processing system. 

SSUBMIT starts (or restarts) job queue processing, if necessary, and then allows you to enter job 
queue commands. 

For information on submitting jobs by a program, refer to Event Driven Executive Language 
Programming Guide. 



■ 



Invoking $SUBMIT 

You invoke $SUBMIT with the $L operator command or option 10.2 of the session manager. 

You must start the job queue processor, $JOBQ, the first time you invoke $SUBMIT. You are 
prompted for a partition number in which to load $jobq. However, you do not need to select a 
partition. Just press the enter key and the operating system selects a partition large enough to 
contain $jobq. If you do not want to start the job queue processor, respond N and $submit 
ends. 



> $L SSUBMIT 

LOADING SSUBMIT 8P, 09: 18:62, LP=2300, PART=2 

SSUBMIT - EDX JOB QUEUE SUBMISSION PROGRAM 

ENTER '?' AT ANY TIME FOR HELP 

THE JOB QUEUE PROCESSOR MUST BE LOADED TO CONTINUE. LOAD IT (Y/N)? Y 

PARTITION NUMBER (1-8) OR ENTER FOR ANY: k 

THE JOB QUEUE PROCESSOR ($JOBQ) IS IN SUSPENDED MODE. 
USE THE "RJQ" COMMAND IN $JOBQUT TO RESUME PROCESSING. 

JOB QUEUE PROCESSOR LOADED INTO PARTITION k 

COMMAND (?): 
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$SUBI\/IIT - Submit/Control Jobs in Job Queue Processor (continued) 

$SUBMIT Commands 

To display the $submit commands, enter a question mark in response to the prompting message 
COMMAND (?): 





COMMAND (?): ? 

DJ - DELETE A JOB 

HJ - HOLD A JOB 

RJ - RELEASE A JOB 

SJ - SUBMIT A JOB 

SH - SUBMIT A JOB AND HOLD IT 

STQ - DISPLAY THE STATUS OF JOB QUEUE PROCESSING 

DCH - DETACH $SUBMIT; RESUME-ATTN SUBMIT, END-ATTN ENDSUB 

EN - END $SUBMtT 

COMMAND (?): 



A 



After $SUBMIT displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, Sj). 

Each command and its explanation is presented in alphabetical order on the following pages. 
DJ — Delete a Job 

Use the Dj command to delete a job that is either waiting for execution or is being held. Identify 
the job to be deleted with the job number displayed when the job was submitted. 

Note: To cancel an executing job, use the $c operator command. 

Example: Delete job 5: 



'\^ 



COMMAND (?) 
JOB NUMBER; 



DJ 



ARE YOU SURE YOU WANT TO DELETE JOB 5? 
JOB 5 DELETED 

.COMMAND {?): 






UT-504 SC34-0644 



$SUBMIT 



o 



$SUBMIT - Submit/Control Jobs in Job Queue Processor (continued) 

DCH — Detach $SUBMrT 

Use the DCH command to place SSUBMIT in suspended mode. To resume processing, press the 
attention key, enter SUBMIT, and press the enter key. If you suspend $submit, the job queue 
processor remains active and any jobs executing complete processing. 

To end $submit once it is in suspended mode, press the attention key and enter endsub. 

Example 1 : Suspend $SUBMIT and then resume processing. 



COMMAND (?): DCH 
>SUBMIT 
COMMAND (?): 



Example 2: End $submit. 

COMMAND (?): DCH 
>ENDSUB 



^ 



$SU8MIT ENDED 



EN — 



End$SUBMIT 

Use the en command to end the $submit utility. 

Example: End the $submit utility: 

COMMAND (?): EN 
$SUBMIT ENDED 
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$SUBMIT - Submit/Control Jobs in Job Queue Processor (continued) 



HJ — Hold a Job Waiting for Execution 



Use the hj command to place a job waiting for execution into a hold state. You must identify 
the job to be held with the job number displayed when the job was submitted. If you have 
submitted many jobs and cannot remember the job number of the specific job you wish to hold, 
use the stq command to display a list of the jobs in the data set. 

Example: Hold job 26 (a job already submitted) for later execution. 

COMMAND {?): hJ 

JOB NUMBER: 26 

JOB 26 HELD 
COMMAND (?): 



Once a job is placed in a hold state, you can release it for execution using the RJ command or 
delete it using the dj command. 



RJ — Release a Held Job 



Use the RJ command to release for execution a job that is being held currently. To identify the 

job you wish to execute, enter the job number of the held job. Use the STQ command to display 

the status of individual jobs. ,C~~^ 

Example: Release job 17 for execution: 

COMMAND (?): rj 

JOB NBMBER: 17 

JOB 17 RELEASED 
COMMAND (?): 



SJ — Submit Jobs to the Job Queue Processor 



Use the SJ command to submit jobs for execution. You are prompted for the name of the 
$JOBUTiL command data set to be executed. 

Optionally, you can assign a priority to the job you wish to execute. Four priorities are 
available, zero through three, where zero is the highest priority. Jobs with higher priorities 
execute before those with lower priorities. For example, if you want a particular job to run 
before other jobs, you can assign it a higher priority. On the other hand, you might not care 
how quickly a job executes. In this case, you do not assign a priority to the job. Just press the 
enter key, or enter an asterisk, in response to the JOB priority: prompt, and $SUBMIT assigns 
priority 2 to the job. 
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$SUBMIT - Submit/Control Jobs in Job Queue Processor (continued) 

Example: Submit two jobs, one with and one without priority. The first job is submitted 
without a priority using prompt-reply mode; the second job is submitted specifying a priority of 
1 using the single-line format. When using single-line format, enter the responses in the order 
the system expects them. 



r. 



COMMAND {?): SJ 

ENTER COMMAND DATA SET (NAME .VOLUME) : COMP I LE ,CANPRC 

ENTER A PRIORITY FROM TO 3 (DEFAULT 2): 

JOB PRIORITY DEFAULTED TO 2 



A 



JOB NUMBER 5 
COMMAND DATA SET 
JOB PRIORITY 



SUBMITTED 

COMPILE.CANPRC 

2 



COMMAND(?): SJ J0B1,EDX002 1 



v. 



JOB NUMBER 6 
COMMAND DATA SET 
JOB PRIORITY 

COMMAND (?): 



SUBMITTED 
J0B1,EDX002 

1 



SH — Submit Job and Hold 



Use the SH command to submit a job and place it into an immediate hold state. For example, a 
job may require specific diskette or tape data sets that are not available at the time you submit 
the job, or you may want to make sure a certain execution sequence is followed. By holding the 
job, you can set up the environment and then release the job for execution using the rj 
command. If you decide to delete a held job, use the dj command. 

Example: Submit and hold a job with a priority of 3. 



COMMAND (?): SH 

ENTER COMMAND DATA SET (NAME .VOLUME ) : ASMJOB 1 .EDX002 

ENTER A PRIORITY FROM TO 3 (DEFAULT 2): 3 



JOB NUMBER 7 : 
COMMAND DATA SET: 
JOB PRIORITY : 


SUBMITTED AND HELD 

ASM0BJ1,EDX002 

3 


COMMAND (?): 
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$SUBMIT - Submit/Control Jobs in Job Queue Processor (continued) 

STQ — Display the Status of Job Queue Processing 

Use the STQ command to display the status of job queue processing and the status of individual 
jobs. STQ displays the jobs in the order in which they were submitted. For each job in the 
queue, $SUBMIT displays the following: 

• Job number 

• Command data set name 

• Job priority 

• Individual job status — waiting, held, executing. 
Example: Display status of job queue processing. 



'COMMAND (?) 



STQ 



JOB QUEUE PROCESSING IS IN EFFECT 

LOGGING TERMINAL IS $SYSLOG 

JOB NUMBER | COMMAND DATA SET | PRIORITY | STATUS 



2 OVERNITE.USRVOL 

3 CALCJOB .PAYROL 
k CHECKS .PAYROL 

5 CALCJOB ,EDX002 

6 J0B1 ,EDX002 

7 ASMJ0B1 ,EDX002 

NUMBER OF JOBS QUEUED IS 6 

COMMAND (?): 

V 



HELD 

WAITING 

EXECUTING 

WA I T I NG 

WAITING 

HELD 
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$S1 ASM - Series/1 Assembler 

$S1ASM assembles source programs coded in Series/ 1 assembler language into object modules. 
The source program can include Series/ 1 assembler language macros such as the commands 
provided by the Event Driven Executive Macro Library. 

If you have a mixture of Series/ 1 assembler language statements and edl instructions, you must 

use $S1ASM. 

If your program contains only EDL instructions, use $EDXASM; your processing will be much 
faster. For more information, see the "$EDXASM - Event Driven Language Compiler" on 
page UT-265. 

Before using $S1ASM, you must enter the source program onto a disk or diskette data set with 
one of the text editor utilities ($editin or $fsedit). 

Required Data Sets 

$S1ASM requires the following data sets. You must specify these data sets in the order shown 
when you use the $L operator command to invoke $S1ASM. The source program input data set 
and the object data set must be specified when you invoke $siasm using the session manager. 

1 . The source program input data set (DSl) contains the program to be assembled. Use a text 
editor ($EDIT1N or $FSEDIT) to create the source data set. You must specify the name of this 
data set when you invoke $S1ASM. 

2. Three work data sets (DS2-DS4) are used by the assembler. They contain object code, 
relocation pointers, the symbol table, and other information. You must allocate these data 
sets if you use the $L operator command to invoke $S1ASM. For most programs, sizes of 
3000, 3000, and 800 records for asmwrki, asmwrk2, and asmwrk3„ respectively, are 
sufficient. The sizes can increase when assembling a large program containing many macro 
calls. Specify the names of these data sets you allocated as a parameter on the $L operator 
command. These data sets are allocated automatically by the session manager. 

3. The object data set (DS5) will contain the output object module from the assembly. It serves 
as input to the linkage editor. A size of 50 to 100 records is sufficient for most programs. 
You must allocate this data set and specify its name when you invoke $S1ASM. 



Invoking $S1 ASM 



You invoke $S1ASM with the $L operator command, with option 2.3 of the session manager, or 
with the $JOBUTlL utility. In each case, you must provide the same information when you load 
$S1ASM for execution. 

You can cancel the assembly or subsequent listing at any time by pressing the attention key and 
entering CA. 
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$S1 ASM - Series/1 Assembler (continued) 

Assembler Options 

The $S1ASM assembler has several options. You specify the option(s) you want when you 
invoke $S1ASM. To direct the processing done by the assembler, the following assembler options 
are available. 

LIST/NOLIST LIST tells the assembler to write all assembly listings to the print file. 

NOLIST tells the assembler to write only the statistics and diagnostic 
messages, if any, to the print file. 

TEXT/NOTEXT TEXT tells the assembler to write the source and object program 

listings to the print file. 

NOTEXT suppresses this process. 

ESD/NOESD ESD tells the assembler to write the external symbol dictionary before 

the source program listing. 

NOESD suppresses this process. 

RLD/NORLD RLD tells the assembler to write the relocation dictionary after the 

source program listing. 



\^ 



>■. 



NORLD suppresses this process. (^ 

XREF/NOXREF/FULLXREF 

XREF tells the assembler to write the cross-reference Usting to the 
print file for only referenced symbols. 

NOXREF suppresses this process. 

FULLXREF tcUs the assembler to write the cross-reference listing to 
the print file for all defined and referenced symbols. 

OBJECT/NOOBJECT OBJECT causes the object module to be written to the OBJOUT data 

set. 

NOOBJECT suppresses this process. 

MACRO/NOMACRO MACRO tells the assembler to process any macros encountered in the 

source. 

NOMACRO suppresses this process. 



o 
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$S1 ASM - Series/1 Assembler (continued) 



SYSPARMC...') 



LINECOUNT(n) 



SETC(n) 



Defines up to 8 characters of information substituted for the 
&SYSPARM value during macro processing. Blanks may be contained 
within the apostrophes. Each blank counts as one character. A 
single apostrophe within the string must be represented by two 
apostrophes. The default value for &sysparm is a null character 
string. 

LINECOUNT specifies n as the number of lines per page of the print 
data set. If this option is omitted, the default line count is 55. The 
value of n must be in the range 1-999. 

SETC specifies n as the maximum number of characters allowed to be 
assigned to SETC symbols. The default value is assigned as 64 
characters. The value must be in the range 2-98. If the assigned 
value is odd, it is rounded up to the next even number. 



END 
CA 



END terminates the option processing. 
CA cancels the assembly. 



You must enter option(s) separated by commas. The default options are LIST, OBJECT, and 

MACRO 



^*"> 
\*^' 



> 



Data Sets Used in Examples 

For illustrative purposes, assume that: 

EDX002 is the IPL volume; 



Data sets asmsrc and asmobj are on the ipl volume; 

WORK contains the WKl, WK2, and WK3 data sets; 

PRNTRi is the name of a print device; and 

$S1ASM is to have 32K bytes of dynamic storage allocated to it. 

Note: Unless you override the default dynamic storage size, $S1ASM uses 22K bytes of the 
partition for a work area. If space in the partition is severely limited, $siasm will execute 
with less dynamic storage work space. If more space is available, you can improve $S1ASM 
performance by specifying more dynamic storage work space. Dynamic work space for 
$S1ASM must be in the range of 8704 to 57344 bytes. 



Assembling a Program Using the $L Operator Command 

Assembling a program using the $L operator command involves loading the assembler, 
specifying macro libraries (if any), and specifying assembly options. 
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$S1 ASM - Series/1 Assembler (continued) 



Loading $S1ASM 



When you assemble a program with the $L operator command, load $siasm from the asmlib 
volume. 

The following example shows the prompt/reply sequence for invoking $S1ASM, specifying 32K 
of dynamic storage work area. 



> $L $S,1ASM,ASML I 8.32768 

SOURCE (NAME, VOLUME^ 

WORK! (NAME, VOLUME) 

W0RK2 (NAME, VOLUME) 

W0RK3 (NAME, VOLUME) 

OBJECT (NAME, VOLUME) 

MACLIBl (?): 



ASMSRC 
WK1 ,WORK 
WK2,W0RK 
WK3,W0RK 
ASMOBJ 



The following single-line entry is equivalent to the multiUne entries above. 



> $L SS1ASM, ASMLIB, 32768 ASMSRC WKl.WORK WK2,W0RK WK3 ,WORK ASMOBJ 
MACLIBl (?): 



o 



Specifying Macro Libraries 

If you require macros for an assembly, you can specify one or two macro library volumes. 

In both of the previously shown methods of loading $siasm, you are then prompted as follows: 
MACLIBl (?): 



Im/ 



A null response (enter) causes the next prompt (enter options) to appear. If you specify a 
macro library for the maclibi prompt (as shown in the following example), another prompt 
(MACLIB2) appears: 



MACLIBI (?): mACLBI 
MACLIB2 (?): 



You can supply the name of another macro library or enter a null response. 

Note: If your source program contains Event Driven Language instructions, you must specify, 
as either maclibi or MACLIB2, the name of the volume (s) that contains the Event Driven 
Executive Macro Library and copy code. 



v.. 



^l|lha«jJ 



y 
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$S1 ASM - Series/1 Assembler (continued) 



Specifying Assembly Options 



After entering the macro library volume name(s) or a null response, you are prompted as 
follows: 



I 



ENTER OPTIONS (?): 



After the prompt appears, you can: 

• Enter a null response and take the default options (list, object, macro). 

• Enter the options you desire (for example, list, noxref, norld). See "Assembler Options" 
onpageUT-510. 

• Enter a question mark to display a list of the options. After the options are displayed, the 
ENTER OPTIONS (?): prompt is displayed. Enter the option(s) you want. 

• Enter the options, followed by the name of your output device. 

If you do not specify the name of the output device with your options, as follows: 



I 



ENTER OPTIONS (?): L I ST, NOXREF , NORLD 



you are prompted with: 



I 



ENTER OUTPUT DEVICE NAME: 



You can enter the name of the device on which your listings and diagnostic messages are to be 
written. You can specify an asterisk (*) to direct the listings back to your loading terminal. If 
you do not specify an output device (a null response), the output device defaults to $sysprtr. 

The next message $S1ASM displays is: 
I CPAOOOI ASSEMBLER STARTED 
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$S1 ASM - Series/1 Assembler (continued) 



Example: The follomng examples shows how to use single-line entry and prompt-mode entry 
and use: 

• ASMSRC for the source library 

. WK1,WK2, and WK3 for work files 

• ASMOBJ for the output file 

• MACLBl for the macro hbrary 

. PRNTRl for the output Usting. 

Single-line Format: This example illustrates how to specify multiple data sets/volumes using 
single-line entry. 



> $L SS1ASM,ASMLIB ASMSRC WKl.WORK WK2,W0RK WK3,W0RK ASMOBJ 
MACLIBl (?): „aCLB1 
MACLIB2 {?): 
ENTER OPTIONS (?) 



LIST.NOXREF.NORLD PRNTRl 



CPAOOOI ASSEMBLER STARTED 



Prompt/ Reply Format: This example illustrates how to specify multiple data sets/volumes 
in prompt mode. 



\A 0/ 



> SL $S1ASM,ASMLIB 

SOURCE (NAME, VOLUME) 
WORK! (NAME, VOLUME) 
W0RK2 (NAME, VOLUME) 
W0RK3 (NAME, VOLUME) 
OBJECT (NAME, VOLUME) 



ASMSRC 

WKl.WORK 

WK2,W0RK 

WK3,W0RK 

ASMOBJ 



MACLBl 



MACLIBl (?) 

MACLIB2 (?): 

ENTER OPTIONS (?): l I ST,NOXREF ,NORLD 

ENTER OUTPUT DEVICE NAME: rrnTRI 

CPAOOOI ASSEMBLER STARTED 



J 
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$S1 ASM - Series/1 Assembler (continued) 



Assembling a Program Using the Session Manager 

To invoke $S1ASM using the session manager, select option 2 from the program preparation 
secondary option menu. 

Figure 30 shows the input menu for entry of the required data sets and optional parameters. 
Source data set asmsrc is to be assembled and the object output is directed to data set asmobj. 



$SMM0203: SESSION MANAGER $S1ASM PARAMETER INPUT MENU 
ENTER/SELECT PARAMETERS: PRESS PF3 TO RETURN 

SOURCE INPUT (NAME,VOLUME): ===> ASMSRC ,EDX002 

OBJECT OUTPUT (NAME .VOLUME) : ===> ASMOBJ ,EDX002 

ENTER OPTIONAL PARAMETERS BY POSITION: 

MACLB1 PRNTR1 L I ST,NORLD .NOXREF 

1 2 3 : ^ 

MACLIBl MACLIB2 PRINTER ASSEMBLER OPTIONS SEPARATED BY COMMAS 
(VOLUME) (VOLUME) NAME LIST/NOLIST XREF/NOXREF/FULLXREF 

TEXT/NOTEXT MACRO/NOMACRO 
ESD/NOESD OBJECT/NOOBJECT 
RLD/NORLD LINECOUNT(N) N=LINES/PAGE 

DEFAULT OPTIONS ARE: L I ST, OBJECT .MACRO 

^^_^^^^^^^^^^^^^^^^^^^^^^^,^_^^^_^^^^^_^^,_,^_^^^^^__^_^_^^,,^^^^_^^^^^^_,_^_,„_^^ 

Figure 30. $S1ASM parameter input menu 



A 
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$S1ASM -Series/1 Assembler ^co/>f/nc/ec/; _^ 

o 

Assembling a Program Using $JOBUTIL 

You can invoke $S1ASM with the job stream processor $JOBUTlL. The same options are available 
through the farm facility of $jobutil as were described previously under the $L command. If 
you require the default options, you can leave the FARM card blank, but you must include it in 
the procedure. 

The following is a sample procedure: 

PROGRAM $S1ASM,ASMLIB 



PRNTR1 LIST.NOXREF.NORLD 



Note: Parameters of the farm statement are column- dependent: 

MACLBi,if coded, must start in column 10. 
MACLB2, if coded, must start in column 20. 
FRNTRi, if coded, must start in column 30. 
The option Ust, if coded, must start in column 40. 



DS 


ASMSRC 


DS 


WKl.WORK 


DS 


WK2,W0RK 


DS 


WK3,W0RK 


DS 


ASMOBJ 


PARM ■ 


MACLBl 


EXEC 





$S1ASM Output 






y 



Upon successful completion of $siasm, the object data set will contain the output of the 
assembler. For a description of that output, refer to the IBM Series/ 1 Event Driven Executive 
Macro Assembler Reference. 
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$S1S1UT1 - Series/1 -to-Series/1 



You can use $S1S1UT1 to invoke the IPL feature and perform data transfer and status operations. 

After the Series/ 1-to-Series/l Attachment is installed, use the EC (echo test) command of 
SSlSlUTl to verify that the attachment is installed correctly. 

$S1S1UT1 can also be used to check out an application. For example, if the application on the 
initiating processor issues a printext, the re (read) command of $S1S1UT1 can be used on the 
responding processor to read the data from the PRINTEXT. 



Invoking $S1S1UT1 



You invoke $S1S1UT1 with the $L operator command or option 4.8 of the session manager. 
$S1S1UT1 must be active on two connected processors for processor-to-processor communication 
via the re (read), WR (write), and AB (abort) commands. For example, if you issue a WR 
command on one processor, then a corresponding re command must be issued on the other 
processor. 

When you load $S1S1UT1, it immediately issues a dd (define device) command to obtain the 
terminal name. 



> $L $S1S1UT1 

LOADING $S1S1UT1 38P ,02 : 52:52 , LP= 0000, PART= 2 

"?" FOR LIST OF COMMANDS 

ENTER S1S1 DEVICE NAME: 



$S1S1UT1 Commands 



To display the $S1S1UT1 commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?):. 

COMMAND{?): ? 

AB PERFORM WRITE ABORT 

DD DEFINE DEVICE NAME 

IP IPL OTHER PROCESSOR 

RE READ DATA 

RS RESET DEVICE 

WR WRITE DATA 

EN END THE PROGRAM 

EC ECHO TEST 

ST OBTAIN STATUS 



V 



COMMAND(?) 



J 



After the $S1S1UT1 displays commands, you are again prompted with COMMAND(?):. Then you 
can respond with the command you want (for example, ab). Each command and its explanation 
is presented in alphabetical order on the following pages. 
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$S1S1UT1 - Series/1 -to-Series/1 (continued) 



AB — Perform Write Abort 

Use the AB command to issue a "write abort" for a pending operation on the initiating 
processor. $S1S1UT1 issues the write abort operation to the attachment specified by the most 
recent dd command. This command is used by the responding processor to end a data transfer 
operation abnormally. 

Example: 



COMMAND(?): AB 
ABORT OPERATION? 

COMMAND(?): 



DD — Define Device Name 



EC — Echo Test 



Use the DD command to specify the terminal name of the attachment used for all ENQTS of the 
attachment for subsequent operations, until you issue another DD command. The terminal name 
is the name specified on the TERMINAL configuration statement at system generation. 

Example: 



COMMAND(?): qd 

SlSl DEVICE NAME: SISIOO 



COMMAND(?) 



/if 



_y 



Use the EC command to verify that the attachment is installed correctly. It results in a 
continuous exchange of 1024-byte records between the attached processors. To terminate EC 
press the attention key and enter "EC." 

Example: 



COMMAND(?): ec 

ECHO EXEftCISE 

ATTN "EC" TO STOP ECHO TEST 

ATTEMPTING TO SYNCH UP 

IK DATA TRANSMITTED 

IK DATA RECEIVED 

DATA CHECKS OUT! 

(Attention) 
^ EC 

COMMAND(?): 



o 
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$S1S1UT1 - Series/1 -to-Series/1 (continued) 

EN — End the Program 

Use the en command to end the $sisiUTi utility. 

Example: 

COMMAND(?): EN 

$S1S1UT1 ENDED AT 00:00:00 



IP — IPL the Other Processor 



"X 



Use the IP command to issue an IPL (initial program load) command to the secondary processor, 
if it is the primary processor issuing the IP command. $S1S1UT1 prompts you for the member 
name and volume that contain the nucleus to be transferred to the secondary processor. 

The nucleus being transferred must begin with the characters $EDXNUC. It must be a single 
partition supervisor with no overlays. The IPL bootstrap program, IPLSISI, must be located in 
the IPL volume; $S1S1UT1 prompts you to verify that the volume name specified is correct. You 
are also asked if the secondary system has a disk or diskette device and for the address of that 
device. The specified disk or diskette becomes the default direct-access device for disk I/O 
operations on the processor being initialized. The bootstrap program is sent to the slave and it 
reads the specified nucleus, 1024 bytes at a time, across the attachment. Control is passed to 
the nucleus upon completion of the transfer. 

Example: 

COMMAND(?): Ip 

ENTER NUCLEUS DSN: $EDXNUC 

ENTER NUCLEUS VOLUME: EDX002 

IS THERE A DEFAULT DISK DEVICE FOR THE NUCLEUS? Y 

SUPPLY DISK/DISKETTE DEVICE ADDRESS(HEX) : k8 

IPL PROGRAM NAME: IPLSISI ON VOLUME: EDX002 

OK? Y 

READY FOR IPL? Y 
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$S1S1UT1 - Series/1 -to-Series/1 (continued) 



RE — Read Data 



Use the RE command to issue an ENQT instruction for the terminal name specified by the most 
recent dd command. $S1S1UT1 then issues a readtext instruction for that terminal to read data 
from the other processor. If $S1S1UT1 is active on the other processor, a WR command must be 
issued to complete an RE command. 

Example: 



COMMAND(?): RE 

MESSAGE RECEIVED! 

THIS IS TEST DATA RECEIVED 

COMMAND(?): 



RS — Reset Device 



Use the RS command to issue a device reset to the attachment specified by the most recent DD 
command. This command clears any pending interrupt or busy condition. 

Example: 



COMMAND(?): RS 
RESET ATTACHMENT? 

COMMAND{?): 






ST — Obtain Status 



Use the ST command to obtain status information on an operation. The status returned by this 
command is the same as the information returned when a termctrl status instruction is 
issued. 



Example: 



COMMAND(?): ST 

OBTAIN CYCLE STEAL STATUS ALSO? Y 

WAIT FOR HEADER? N 

HEADER WORDS: noo 0^00 

READ(READTEXT) ISSUED BY OTHER CPU 

NO. BYTES = 0400 

DIAGNOSTIC JUMPER WORD: 02E6 

CYCLE STEAL STATUS: (11 words of status) 



^ 



COMMAND(?) 



J 
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$S1S1UT1 -Serles/1-to-Senes/1 (continued) 



WR — Write Data 



Use the WR command to issue an enqt instruction to the terminal name specified by the most 
recent dd command. A printext instruction is then issued for that terminal to write data to the 
other processor. If $S1S1UT1 is active on the other processor, an re command must be issued to 
complete a wr command. 



Example: 



COMMANDC?): WR 

ENTER TEXT: 

TEST DATA TO WRITE 

MESSAGE SENT! 



COMMANDC?) 



V. 
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$TAPEUT1 - Tape Management 



$TAPEUTl performs several commonly-used tape management functions. You can initialize 
tapes, allocate tape data sets, copy data sets or volumes to or from tape, copy tape to tape, print 
tape records, dump/restore disk devices, and test the tape transport hardware. 



Invoking $TAPEUT1 



You invoke $tapeuti with the $L operator command or option 3.10 of the session manager. 
Once invoked and prior to accepting commands, $tapeuti displays the following information 
about the tapes defined to the system: 

• tape identification 

. density selection for the 4969 (800, 1600, dual) or the 4968 (1600, 3200, dual) 

Note: The 3200 density for the 4968 is not ANSI compatible but is compatible with other 
4968 tape units. 

label type (SL: standard label, NL: null label, blp: bypass label processing) 

current density setting 

tape speed (inches per second) - 4968 only 

onUne or offline 

volume information (if an onhne SL tape) 

device address. 

Example: Loading $tapeuti and its automatic display for system tapes. 



> $L STAPEUTl 

LOADING $TAPEUT1 21P, 11:11:33, LP= 0000, PART=2 

TAPEOl DUAL SL 1600 OFFLINE 

DEVICE ADDRESS = OO^C 
TAPE02 DUAL NL 1600 OFFLINE 

DEVICE ADDRESS = OOAD 

COMMAND (?): 



k J 



Once you have invoked $tapeuti, you can Hst this information at any time by using the LT (list 
tape drives and attributes) command. 

Note: Error logging of tape errors is available. Refer to the Problem Determination Guide. 



\J 
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$TAPEUT1 - Tape Management (continued) 



$TAPEUT1 Commands 



To display the $tapeuti commands at your terminal, enter a question mark in reply to the 
prompting message command (?):. 



r 



COMMAND (?): ? 



CD 


COPY TAPE DATA SET 


CT — — 


CHANGE TAPE ATTRIBUTES 


DP — — 


DUMP TAPE 


EN 


END $TAPEUT1 


EX — - 


EXERCISE TAPE 


IT 


INITIALIZE TAPE 


LT -- — 


LIST TAPE DRIVES AND ATTRIBUTES 


MT 


MOVE TAPE 


RC ---- 


DISPLAY TAPE RETURN CODES 


RT 


RESTORE DISK/VOL FROM TAPE 


ST — — 


SAVE DISK/VOL ON TAPE 


TA - — 


ALLOCATE TAPE DATA SET 


COMMAND 


(?): 



c 



After $TAPEUTl displays the commands, it prompts you with COMMAND (?): again. Then you 
can respond with the command of your choice (for example, CD). Each command and its 
explanation is presented in alphabetical order on the following pages. 

CD — Copy Data Set 

Use the CD command to: 

• copy a disk or diskette data set onto a tape 

• copy a tape data set into a disk or diskette data set 

• copy a tape data set onto another tape. 

CD writes a trailer label at the end of the data set on the target tape if it is a standard label tape. 
The system does not write header labels on standard or nonlabeled tapes; therefore, you must 
preallocate the target tape data set. 

If you are copying a disk or diskette data set to tape, the tape records are 256 bytes. If you copy 
a tape data set from another system (for example, an S/370) to a disk or diskette and the source 
records are not 256 bytes, the system splits the source records into multiple 256-byte records 
and pads any unused bytes with zeros. Prior to copying, $tapeuti prompts you for the 
maximum input record size. If the actual record size differs from the input record size, 
$TAPEUTl prompts if you wish to continue processing. $TAPEUT1 issues this prompt every time it 
encounters a record with the wrong length. 
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$TAPEUT1 - Tape Management (continued) 



4 ^ 



Consider the following when you are copying data sets: 

• When you reach a tapemark (end of input data), $tapeuti prompts you to continue. If you 
have more records to copy, you can continue; however, make sure that the target tape has 
sufficient room. $TAPEUT1 prompts at every tapemark it encounters on the source tape. If 
you do not wish to continue, the system writes the trailer label on the target tape. 

• To copy the contents of one tape to another tape, thereby creating an exact dupUcate of the 
entire tape (header label and data records or only data records), you can use either of two 
methods: 

— To copy only data records, initialize the target tape (using the IT command) so that it has 
the same label type as the source tape. Copy (using the CD command) the source tape 
to the target tape. This allows you to create a new header label on the target tape and 
to duplicate only the data records from the source tape. 

— To create an exact duplicate of the source tape, mount the source and target tapes on 
drives specified for bypass label processing. Then copy (using the CD command) the 
entire source tape. The target tape becomes an exact duplicate of the source (all label 
records, all data records, and all trailer labels). 

• If the source data set is larger than the target tape, you can continue copying onto another 
tape. 



/0 



• If the source data set is larger than the target disk data set, you can continue copying into j ^ 
another disk data set. ^-^ 

• You can also combine a multiple disk data set into one tape data set. 



i~^\ 

Vl 
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$TAPEUT1 - Tape Management (continued) 



C 



% 



Example 1 : Copy data from a disk to a tape (standard label tape). 



COMMAND (?): CD 

SOURCE (NAME, VOLUME): $TAPEUT1 ,EDX002 
TARGET (NAME, VOLUME): DATA1 11 1 , 123^56 
ENTER SOURCE BLOCKS I ZE (NULL=D I SK(ETTE) ) 
USE ATTN/CA TO CANCEL COPY 

ARE ALL FARMS CORRECT? (Y,N): Y 
EOD ON SOURCE DATA SET 
25 RECORDS COPIED 

COMMAND (?): 



Example 2: Copy data from a tape (nonlabeled) to a tape (standard labeled). 



COMMAND (?): CD 

SOURCE (NAME, VOLUME): X.TAPEOl 
TARGET (NAME, VOLUME): DATAl 11 1 , 123^56 
ENTER SOURCE BLOCKSIZE (NULL=D I SK(ETTE) ) 
USE ATTN/CA TO CANCEL COPY 

ARE ALL PARMS CORRECT? (Y,N): Y 
EOD ON SOURCE DATA SET 
. 25 RECORDS COPIED 

COMMAND (?): 



J 



V 



Note: TAPEOl is the ID assigned to the tape drive at system generation. 
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$TAPEUT1 - Tape Management {continued) 

CT — Change Tape Drive Attributes 

Use the CT command to reset the label type and density for any tape drive. The label type and 
density are set at system generation. CT allows you to reconfigure the tape drives dynamically. 
You must vary the tape drive offline before you can change its attributes. 




where id is the tape ID assigned to the tape drive during system generation. 

For the 4969, the system displays the current settings for label and density. For the 4968, the 
system displays the current settings for label, density, and tape speed. $tapeuti prompts you to 
enter any changes. 

Note: For the 4968 only, a density selection of 1600 causes the system to set the tape drive 
speed to 25 inches per second (iPS). A density selection of 3200 results in a tape drive speed of 
50 inches per second (iPS). 

The CT command fails and issues an error message on the terminal for the following conditions: 

invahd device address 

tape drive is not varied offline 

invaUd label type 

invalid density 

tape drive not defined as dual density if you tried to change the density. 

Example 1: Specify changes to the label processing and density selection for a 4969 tape drive 
at address 4C. 



TAPED 1 
^ 160" 



COMMAND (?): qj 

ENTER TAPE ID (1-6 CHARS): 

TAPE TAPE01 AT ADDR ^C IS BLP" iTO'O BP I 

DO YOU WISH TO MODIFY (Y OR N)?: y 

LABEL (NULL,SL,NL,BLP)?: jl 

DENSITY (NULL, 800, 1600): gOO 

TAPE TAPEOl AT ADDR 4C IS SL 800 BP I 

COMMAND (?): 



\J 
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$TAPEUT1 - Tape Management (continued) 

Example 2: The system makes no changes for label processing and density selection for a 
4969 tape drive at address 4D. 

COMMAND (?): CT TAPE02 

TAPE TAPE02 AT ADDR k^ I S SL 800 BP I 
DO YOU WISH TO MODIFY (Y OR N)?: ^ 

COMMAND (?): 

DP — Dump Tape Records 

Use the dp command to dump tape record(s) on the system printer (SSYSPRTR), on the terminal 
from which you invoked $tapeuti, or on the terminal you specify. The output format is similar 
to the $DISKUT2 utility: hexadecimal data plus the EBCDIC conversion. 

The system shows the record number for each record and prints the words 'tapemark' when it 
encounters a tapemark. $TAPEUTl prompts you for the number of records you want to print. 
When the system detects a tapemark, $TAPEUTl prompts you to continue or to end the dump. 

$TAPEUTl prompts you for the maximum record size. This allows you to print record sizes up to 
the maximum amount of storage available. If the record you are reading is smaller or larger than 
the maximum size specified, the system issues a message indicating: 

• wrong-length record 

• the actual record size 

The system prints smaller records and pads them with zeros for their length. It truncates larger 
records and prints to the maximum size allowed. $TAPEUTl informs you of the actual record 
size. 

Notes: 

1 . The tape must be varied offline before you can dump records. 

2. The TAPEID you specify must match the one specified at system generation. 

3. This is an offline utility; therefore, the tape will not rewind automatically when the dump 
finishes. Use the move tape command (mt) to rewind the tape. 

4. You can use the dump command (dp) and the move tape command together (mt) to search 
and dump portions of a tape selectively, dp keeps track of the actual record count (along 
with the MT command) and will print this value. However, if you issue a forward space file 
(fsf) control function to move the tape to the end of the file and then issue a back space 
records (bsr) control function to back up the tape a specified number of records, dp cannot 
track the actual record count. As a result, it prints a relative record count with an R printed 
after the number indicating the count is relative. 
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$TAPEUT1 - Tape Management (continued) 



Example: Dump five records on display terminal. 



COMMAND (?): Dp 

ENTER MAXIMUM BLOCKSIZE: 256 

USE ATTN/CA TO CANCEL DUMP 

ENTER TAPE ID (1-6 CHARS): TAPEOl 

ENTER NUMBER OF RECORDS TO DUMP: 5 

PRINT DUMP ON $SYSPRTR? (Y,N): n 

ENTER TARGET TERMINAL NAME (".NAME): '^ 

(The system directs the dump to the terminal 
where you are currently assigned) 



o 



COMMAND (?): 



V 



V 



If you respond Y to the print dump on $SYSPRTR? prompt, the system directs the dump to 
$SYSPRTR If you respond N, $tapeuti prompts you for the terminal name of your choice. You 
can respond as follows: 

• * = terminal where you are currently assigned 

• name = device name of the target terminal. 

If the tape you want to dump is in use, $tapeuti prompts you as follows: 



DEVICE NOT OFFLINE 

DO YOU WISH TO CONTINUE? (Y,N): 



\^ 



If you specify Y, the dump will continue but the device will be unusable by the original user. 

EX — Exercise Tape 

EX, a software exerciser, performs two operations: 

• It exercises any of the three label-type tapes to ensure that the i/o commands to that tape 
are executing correctly. 

• It analyzes the surface of the tape to verify that the surface is free of defects. The system 
prints on the system printer ($SYSPRTR) any errors and their approximate location on the 
tape. 

Note: Surface analysis writes records over the information currently on the tape. This destroys 
any existing data records or labels. 






UT-528 SC34-0644 



$TAPEUT1 






$TAPEUT1 - Tape Management (continued) 






Each operation is optional and the system prompts you before it continues. 
The EX command performs the following functions: 

Writes 600 unique records to a data set on the tape 

Closes and reopens the data set 

Finds a particular record within the data using note/point 

Verifies that it accesses the correct record 

Performs a surface analysis of the tape by writing over the tape. 

If it encounters an error, the system prints the return code and the contents of the buffer. The 
buffer contains all ffff's except for the last word which is the record count of the faiUng record. 

Example: Exercise tape mydata. 

COMMAND (?): EX 

TARGET (NAME, VOLUME): MYDATA, 1 23456 

USE ATTN/CA TO CANCEL THE EXERCISER 

DO YOU WANT TO EXERCISE THE SOFTWARE (Y/N): y 

Exerciser runs and prints status on printer 

WRITE ENTIRE SURFACE OF TAPE? (Y/N): y 

THIS SECTION WILL DESTROY ALL LABEL FIELDS 
DO YOU WISH TO CONTINUE (Y,N): y 

Exerciser writes on entire surface of tape 

COMMAND (?): 



A sample of the data the ex command prints follows. 
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$TAPEUT1 - Tape Management (continued) 



o 



TAPE EXERCISER STARTED 

WRITE 600 UNIQUE RECORDS TO THE TAPE 

TEST DATA WRITTEN 

STEP 1 SUCCESSFUL 

CLOSE DATA SET FOR REUSE VIA SETEOD 

STEP 2 SUCCESSFUL 

READ 250 OF THE RECORDS 

NOTE PRESENT POSITION 

STEP 3 SUCCESSFUL 

POINT TO RECORD 150 AND READ THAT RECORD 

STEP k SUCCESSFUL 

NOTE PRESENT POSITION 

STEP 5 SUCCESSFUL 

VERIFY DATA RECORD 

STEP 6 SUCCESSFUL 

POINT TO RECORD 500 AND READ THAT RECORD 

STEP 7 SUCCESSFUL 



VERIFY 2nd WORD OF TCB CONTAINS ACTUAL BLOCKSIZE 

STEP 17 SUCCESSFUL 

READ UNTIL END OF DATA ENCOUNTERED 

VERIFY LAST DATA RECORD 

STEP 18 SUCCESSFUL 

CLOSE DATA SET FOR REUSE 

STEP 19 SUCCESSFUL 

REOPEN THE DATA SET 

READ 598 OF THE RECORDS 

ATTEMPT TO READ MORE RECORDS WITH 1 STMT THAN ARE AVAILABLE 

VERIFY END-OF-DATA RETURN CODE 

STEP 20 SUCCESSFUL 

VERIFY 2ND WORD OF TCB CONTAINS ACTUAL # REALLY READ 

STEP 21 SUCCESSFUL 

WRITE ENTIRE SURFACE OF TAPE? 

REWIND TAPE TO LOAD POINT 

STEP 22 SUCCESSFUL 

WRITE ENTIRE TAPE 

WRITE TAPE MARKS ON END OF TAPE 

STEP 23 SUCCESSFUL 

REWIND TAPE TO LOAD POINT 

STEP 24 SUCCESSFUL 

CLOSE TAPE OFFLINE 

STEP 25 SUCCESSFUL 



Figure 31. Sample of output from EX (tape exerciser). 



o 
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IT — Initialize Tape 






Use the IT command to initialize a new tape completely or to change the label information on a 
used tape. The it command initializes tapes for nonlabeled and standard label use. 

When you initialize a tape as nonlabeled, the it command writes three tapemarks, deleting any 
previous labels on the tape. 

When you initialize a tape as standard label, the IT command writes on the tape: 

• a volume label (vOLi) 

• a header label (hdri) 

• 2 tapemarks to delimit the label information and to indicate an empty data set 

• a trailer label (EOFi) and 2 tapemarks signifying the end of data on the tape. 
$TAPEUT1 prompts you for the the contents of all required label fields. 
Example: Initialize a standard label tape. 

COMMAND (?): IT 

ENTER TAPE ID (1-6 CHARS): TAPE01 

STANDARD LABEL 1600 BP I ? Y 

TAPEDS (NAME, VOLUME) : DATAin 1,123456 

OWNER ID (1-10 CHARS): OWNER- ID 

EXPIRATION DATE (YYDDD): 79001 

TAPE INITIALIZED 

COMMAND (?): 



Your tape must be varied offline before you can initialize it. If the tape is not offUne, $TAPEUTl 
issues the following warning message: 



V 



WARNING! DEVICE ISN'T OFFLINE 
CONTINUE? 



If you respond Y, $tapeut1 varies the tape offline, initializes it, and varies it online under its 
new name. If you respond N, the IT command ends and $tapeuti prompts you for another 
command. 
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$TAPEUT1 - Tape Management (continued) 

If you are changing the label information on a used tape that has an unexpired data set, 
STAPEUTi prompts you as follows: 






I 



UNEXPIRED DATA SET! 
CONTINUE? 



If you respond Y, $tapeuti varies the tape offline, initializes it, and varies it online under its 
new name. If you respond N, the IT command ends and $tapeuti prompts you for another 
command. 

Notes: 

1 . The system initiahzes your tape with the same attributes (label and density) as those defined 
for the tape drive on which you mounted the tape. Refer to the tape statement in the 
Installation and System Generation Guide. 

2. If you initialize a 4968 tape drive with a density of 3200 BPI, the initialized tape will not be 
ANSI compatible but is compatible with any other 4968 tape unit. 

3. When specifying the volume and data set names, do not use the same names as were 
specified for tape ID at system generation. 

You can also initialize a tape from a program or by invoking $J0BUTIL and passing the following 
parameters: 






Name of mod 


ule: $TAPEIT 






Required parameters: 








LENGTH 


NL 


SL EXPLANATION 


$PARM1 


3 words 


X 


X TAPEID 


$PARIVI4 


4 words 


X 


DS name 


$PARM8 


3 words 


X 


Volume 


$PARM11 


5 words 


X 


Owner ID 


$PARM16 


3 words 


X 


Create date (YYDDD ) 

(if no timers in system) 


$PARM19 


3 words 




X Expiration date(YYDDD ) 



Examples of loading $TAPEIT from a program or through a $JOBUTlL procedure follow. 
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$TAPEUT1 - Tape Management (continued) 






Example 1 : Loading $tapeit from a program for a standard label tape; timers are included in 
the system. 



LOAD 


$TAPEIT, 


FARMS , EVENT= ITWAIT 




WAIT 


ITWAIT 






FARMS 


EQU * 


$TAFEIT PARAMETER 


LIST 


ID 


DATA 


CL6' TAPED 1 ' 


(TAPEID - 3 WORDS) 


DSN 


DATA 


CL8 ' MYDATA ' 


(DATA SET NAME - 4 WORDS) 


VOL 


DATA 


CL6' 10010' 


(VOLUME NAME - 3 WORDS) 


OWNR 


DATA 


CLIO 'SMITH' 


(OWNER ID - 5 WORDS) 


CRDATE DATA 


CL6' ' 


(UNUSED CREATE DATE - 


* 






3 WORDS) 


EXDATE DATA 


CL6'81100 ' 


(EXPIRATION DATA - 


* 






3 WORDS) 


* CREATION DATE AND EXPIRATION DATE ARE YYDDD FORMAT 


* AND 


MUST BE 


LEFT JUSTIFIED WITHIN A 6-BYTE FIELD. 



Example 2: The following figures show the procedures you can set up to initialize tapes 
through the $J0BUTIL utility. 

Figure 32 is a procedure to initialize a standard label tape. In the FARM* statement, you specify 
the TAPEID, data set name, volume, owner identification, create date, and expiration date. 



REMARK 




REMARK 


DEFINE -TAPE01- FOR SL,1600 BPI 


REMARK 


MOUNT A TAPE ON -TAPE01- BUT DO *NOT* VARY ON 


PAUSE 


***** IS THE TAPE MOUNTED? ***** (REPLY -GO-) 


PROGRAM 


$TAPEIT 


********************************************************* 1 


PARM 


TAPE01TEMPDATA123456DEPT563 76100 78100 


EXEC 




JUMP 


OKI ,EQ,-1 



Figure 32. $JOBUTIL procedure for invoking $TAPEIT for an SL tape. 
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$TAPEUT1 - Tape Management (continued) 

Figure 33 is a procedure to initialize a nonlabeled tape. When you initialize a tape as 
nonlabeled, the system writes three tapemarks on the tape deleting any previous labels on the 
tape. 



\Jt J 



REMARK 




REMARK 


**** DEFINE -TAPED 1- FOR 800 BPI S NL PROCESSING 


REMARK 


MOUNT A TAPE ON -TAPED 1- BUT DO *NOT* VARY IT ON 


PAUSE 


***** IS THE TAPE MOUNTED? ***** (REPLY - GO-) 


PROGRAM 


$ TAPE IT 


***************************** 1 


PARM 


TAPED 1 


EXEC 




JUMP 


0K4,EQ,-1 



Figure 33. $JOBUTIL procedure for invoking $TAPEIT for an NL tape. 

Figure 34 is a procedure to test the error code $tapeit returns. 



REMARK 


POST CODE 102 - 


- DEVICE NOT OFFLINE 


PROGRAM 


$TAPEIT 




PARM 


TAPED 1 




EXEC 






JUMP 


ERR3,EQ, 102 




invoked thro 


jgh $JOBUTIL 





\^ 



,J^ 



Figure 34. Testing the post code returned by $TAPEIT wlien 

If you initialize a tape by loading $tapeit from a program or by invoking $JOBUTlL and passing 
the above parameters, the system returns following post codes. 

Code Condition 

-1 Function successful. 

RC Any tape I/O return code. 

101 TAPEID not found. 

102 Device not offUne. 

103 Unexpired data set on tape. 

104 Cannot initialize BLP tapes. 



^StlBllI 
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$TAPEUT1 - Tape Management (continued) 

LT — List Tape Drives and Attributes 

Use the LT command to list all the tape drives defined to the system and the attributes of each 
on the terminal where you invoked $tapeuti. The information displayed for each tape drive is 
as follows: 



•">. 



TAPEID 

density selection for the 4969 (800, 1600, DUAL) 
density selection for the 4968 (1600, 3200, DUAL) 
label type (SL, NL, BLP) 
current density setting 
current tape speed (4968 only) 
status (online or offline) 
volume information (if an online SL tape) 
device address 
Example: 



COMMAND (?) 



LT 



TAPE DUAL SL 1600 OFFLINE 
DEVICE ADDRESS = 004C 

TAPE DUAL NL 1600 OFFLINE 
ADDRESS = 004D 

COMMAND {?): 
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MT — Move Tape 



Use the mt command to control tape motion on the specified tape. The available control 
functions are: 

BSF - Back space file 

BSR - Back space records 

FSF - Forward space file 

FSR - Forward space records 

OFF - Set device offline 

REW - Rewind 

ROFF- Rewind offline 

WTM - Write tapemark 

A count is available for FSR, BSR, FSF, BSF, and WTM so that you can specify the number of 
records or files you want to space over or the number of tapemarks you want to write. 

An EOT (end-of-tape) terminates only the write tapemark (wtm) function and issues a return 
code. If you wish to proceed past the EOT, you must request another WTM. 

Notes: 

1 . You can proceed past the EOT, but make sure that there is sufficient tape to perform the 
operation. 

2. The tapemark record is smaller than the end-of-tape (eot) foil indicator so you could 
receive two or more end-of-tape strip indications for the same EOT. 

A tapemark ends FSR or BSR operations and the system positions the tape following that 
tapemark. 

Example: Move tapeoi forward 3 records. 






COMMAND (?): ^T 

ENTER TAPE ID (1-6 CHARS): JAPEOl 

TYPE? FSR/BSR/FSF/BSF/WTM/REW/ROFF/OFF ; 

"' the action occurs * 

FSR SUCCESSFUL 

TYPE? FSR/BSR/FSF/BSF/WTM/REW/ROFF/OFF : 

COMMAND (?): 

v.. 



FSR 3 



END 



m^ iJ 
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$TAPEUT1 - Tape Management (continued) 

If the tape is positioned at the first record and the utility forward spaces 3 records, it positions 
the tape at the 4th record. 

Notes: 

1 . You must vary your tape offUne before you can issue the motion commands. If you have 
not varied the tape offhne, the system issues a warning message and $tapeuti prompts you 
to continue. 

2. The response to enter tapeid must be the same tapeid that you specified at system 
generation. 

3. This is an offline utility; therefore, the system will not reposition or rewind the tape when it 
ends. Use the REW command to rewind the tape. 

4. The MT command keeps track of the actual record count so you can print this value with the 
DP command. However, if you issue a forward space file control function (fsf) to move the 
tape to the end of the file and then issue a back space records control function (bsr) to back 
up the tape a specified number of records, MT cannot track the actual record count. When 
this occurs, MT keeps track of the relative record count (relative to the start of the tape) and 
DP prints this value with an R printed after the number indicating the count is relative. 
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RC — Display Tape Return Codes 

Use the RC command to display the tape return codes on the terminal where you invoked 

$TAPEUT1. 

Example: Display tape return codes. 



COMMAND (?): rq 



■> 



1 EXCEPTION BUT NO STATUS 

2 ERROR READING CYCLE STEAL STATUS 

3 I/O ERROR - RETRY COUNT EXHAUSTED 

k ERROR ISSUING READ CYCLE STEAL STATUS 

6 I/O ERROR ISSUING NORMAL 010 

10 END OF DATA - A TAPE MARK HAS BEEN READ 

21 WRONG LENGTH RECORD 

22 DEVICE NOT READY 

23 FILE PROTECT 
Ik END OF TAPE 

25 LOAD POINT 

26 UNRECOVERABLE I/O ERROR 

27 SL DATA SET NOT EXPIRED 

28 INVALID BLOCKS I ZE 

29 OFFLINE, IN-USE. OR NOT OPEN 

30 INCORRECT DEVICE TYPE 

31 CLOSE INCORRECT REQUEST 

32 CLOSE BLOCK COUNT ERROR 

33 CLOSE DETECTED AN EOVl 

COMMAND (?): 



J 
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$TAPEUT1 - Tape Management (continued) 

RT and ST - Saving and Restoring a Disl^ Device, Volume, or Data Set 

To save a disk device, volume, or data set on tape, use the ST command. To restore a disk 
device, volume, or data set from tape, use the RT command. Two functions are available that 
these commands use: 

• The first function (called the double-buffered function) uses two buffer areas to hold the 
output from tape or disk. As the first buffer area is emptying its contents, the utility is 
filling the second buffer area. By using two buffer areas, the tape drive or disk never has to 
wait for the system to empty the contents of the buffer area. If the system has sufficient 
storage available (we recommend a 64K area), it will always use the double-buffered 
function. 

• The second function (called the single-buffered function) uses one buffer area to hold the 
output from tape or disk. As a result, the tape drive or disk has to wait for the the system to 
empty the contents of the buffer area to disk. 

To help you monitor the save and restore processes, $tapeuti issues a progress report to the 
terminal where you loaded the utility. The report contains the total number of records the utility 
must transfer and the number of records that it has transferred already. The system issues the 
progress report only if you are operating under the double-buffered function. 

Example: In this progress report, the utility must transfer a total of 10000 records. The 
current number of records it has transferred already is 5760. 



TRANSFER TOTAL= 10000 CURRENT= 5760 



As the transfer takes place, the system updates the current= number on your screen until it 
completes the operation. Once the operation completes, the TOTAL= and CURRENT= numbers 
are the same. 

In addition, when you save or restore tapes using the double-buffered function, you can initialize 
and vary tapes online automatically. 

RT - Restore Disl< Device, Volume, or Data Set from Tape 

Use the RT command to restore a disk device, volume, or data set from tape. To restore 
information from a tape, you must have created the tape previously using the ST command in the 
same version of EDX. In addition, you can restore a disk volume from a tape to the same device 
type or a different device type, except for the IPL volume. (The system treats the IPL volume 
similarly to a disk device; you must restore it to the same device type.) To restore an entire disk 
device from tape, the device type and model number of the source and target disks must match. 



Chapter 4. Utilities UT-539 



$TAPEUT1 

$TAPEUT1 - Tape Management (continued) 



Two restore functions are available to the rt command: 

• The first function (called the double-buffered function) uses two buffer areas to hold the 
output from tape. 

• The second function (called the single-buffered function) uses one buffer area to hold the 
output from tape. 

Automatic Varyon: If you choose automatic varyon and $tapeuti can load the 
double-buffered function, it issues the following messages: 

VOLUME RESTORE OF MYVOL FROM TAPE TAPE##00,VOLSAV OK? (Y,N): y 
USE ATTN/CA TO CANCEL THE RESTORE 



The system automatically varies online each tape used in the restore process. 

If it cannot load the double-buffered function, $tapeuti attempts to load the single-buffered 
function and issues the following messages: 

INSUFFICIENT MEMORY TO LOAD DOUBLE-BUFFERED UTILITY 



LOADING SINGLE-BUFFERED UTILITY 

- WARNING - NO DATA STREAM CAPABILITY WITH SINGLE-BUFFERED UTILITY 

SAVE/RESTORE TIME MAY BE SIGNIFICANTLY INCREASED 



V. 



J 



Note: $TAPEUTl issues the warning message only if you are using a 4968 tape unit. 

If $TAPEUTl is successful in loading the single-buffered function, you can proceed with the 
restore process; however, you must vary each tape online with the $ varyon operator command. 

If $TAPEUT1 cannot load the single-buffered function, it issues return code 70, indicating that 
there is not enough storage to load the function, and issues the COMMAND (?): prompt. 

Note: To have sufficient storage available for the double-buffered function, we recommend that 
you load the $tapeuti utility into a full 64K partition. 



\^J 
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When you enter RT, $tapeuti issues the following message: 
I AUTO VARYON MODE? (Y,N): Y 

If you respond Y, $tapeuti automatically varies each tape online. 

If you respond N, you must vary each tape online yourself. 

Then enter all the parameters necessary for the restore function. The following example shows 
the parameters necessary for a volume restore using automatic varyon. 

ENTER TAPEID (1-6) CHARACTERS): TAPE02 



" WARNING: TO ENSURE PROPER 

* DISK CONTENTS, THE SYSTEM 

* SHOULD BE INACTIVE WHILE 
" RUNNING THIS UTILITY 



RESTORE OPTIONS: 

1 = DEVICE 

2 = VOLUME 

3 = DATA SET 
k = EXIT 

ENTER RESTORE OPTION: 2 

ENTER TARGET DISK VOLUME NAME: MYVOL 

TAPE##00,VOLSAV ONLINE 

(The utility varies the source tape online automatically) 



After you enter the necessary parameters, $tapeuti attempts to load the double-buffered 
function. 

Nonautomatic Varyon Mode: If you choose nonautomatic varyon mode, $tapeuti goes 
through the same procedure as outlined under the "Automatic Varyon:" on page UT-540. 
However, you will need to use the $VARYON operator command to vary online each tape used in 
the restore process. 
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Restoring Multiple Tapes: $tapeuti then prompts you to mount any additional tapes it 
may need to complete the restore. In the following example using the double-buffered utihty 
(automatic varyon mode), $tapeuti prompts you to mount tape##01 which is the next tape in a 
series of two tapes you are restoring. 



MOUNT TAPE##01,V0LSAV 

REPLY Y WHEN TAPE MOUNTED AND TAPE DRIVE ONLINE? Y 

TAPE##01,V0LSAVE ONLINE 

(The system varies the source tape online automatically.) 



''-^.mJ^ 



If you did not choose automatic varyon mode, use the $ varyon operator command to vary the 
tape online. 



When it has restored the volume, $tapeuti issues the following message and prompts you for 
another command. 



V^ 



VOLUME RESTORED 
COMMAND {?): 



For the 4968 tape unit, once a restore completes successfully, the system rewinds and unloads 
the source tape automatically. This also occurs at the end of each tape (EOT), after the system 
writes the trailer record. If the restore is not successful, the system only rewinds the tape. 



I ) 



Note: If you do not want the source tape to be unloaded after a restore, do not use automatic 
varyon. 

ST — Save a Disk Device, Volume, or Data Set on Tape 

Use the ST command to save an entire disk device, volume, or data set on tape. ST prompts you 
to specify whether you are saving a device, volume, or data set. ST is used in conjunction with 
the restore command (rt) to back up data you wish to protect. 

There are two restore functions available to the ST command: 

• The first function (called the double-buffered utility) uses two buffer areas to hold the 
output from disk. 

• The second function (called the single-buffered utihty) uses one buffer area to hold the 
output from disk. 
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Automatic Initialization: When operating under the double-buffered function, $tapeuti 
automatically initializes each tape during the save process. This means that you need not stop a 
save operation and initialize each tape before saving information on it. 

When using auto initialization, $tapeuti assigns the tape data set name, volume name, and 
owner identification. The default owner identification assigned is "system." The names the 
system assigns for standard label tapes are as follows: 

Save Type Assigned Volume Label 

DATA SET TAPE##XX,DATSAV 

VOLUME TAPE##XX,VOLSAV 

DEVICE TAPE##XX,DEVSAV 

For bypass and nonlabeled tapes, the system assigns only the trailer label as follows: 

Type Assigned Volume Label 

SAVE TAPE##XX,TAPEID (TAPE DRIVE ID) 

SAVE TAPE##XX,TAPEID 

$TAPEUTl increments the last two characters of TAPE##XX for each tape required to complete the 
save process. For example: 

HEADER FOR FIRST TAPE = TAPE##00 

HEADER FOR NEXT TAPE = TAPE##01 (tape trailer from first tape) 

HEADER FOR NEXT TAPE = TAPE##02 (tape trailer from second tape) 

You can modify the names automatically assigned (default parameters) only during initialization 
of the first tape. $tapeuti automatically initializes any subsequent tapes and writes the trailer 
records with the new default parameters. 

After $tapeuti initializes a tape, it issues one of the following messages depending upon the 
type of save (device, volume, or data set): 

DEVICE SAVE OF DISK AT ADDRESS OOCO ONTO TAPE TAPE##00,DEVSAV OK? (Y,N): 

VOLUME SAVE OF MYVOL ONTO TAPE TAPE##00,VOLSAV OK? (Y,N): 

DATA SET SAVE OF DATAl ,EDX002 ONTO TAPE TAPE##00,DATSAV OK? (Y,N): 
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If the target tape volume label is satisfactory, respond Y. If you want to change the label, 
respond N. $tapeuti then prompts you for the new default tape label. 

CHANGE DEFAULT TAPE VOLUME LABEL? (Y,N): Y 

INPUT NEW TAPE VOLUME LABEL (1-6 CHARACTERS): NEWVOL 

INPUT OWNER IDENTIFICATION (l-lO CHARACTERS): D27H 
TAPE#i!'00, NEWVOL TAPE INITIALIZED 

DATA SET SAVE OF DATA1,EDX002 ONTO TAPE TAPE##00, NEWVOL OK? (Y,N): Y 
When you enter ST, $TAPEUT1 issues the following message: 

I AUTO INITIALIZATION MODE? (Y,N): 

If you respond Y, $tapeuti initializes any tapes used for the save process. 

If you respond N, you must initiaUze each tape with the IT command and vary the tape online 
using the $VARYON operator command. 

Then enter all the parameters necessary for the save function. The example shown is for a 
device-save using the double-buffered utility (automatic initialization). 



ENTER TAPE ID (1-6) CHARACTERS): TAPE02 



LJua.xj.ji,a.JL.j.JLJua.j.Juxs(.>i.Jua.xa.JLj.ji,«LjLXJLJLj.xj.Jt.Ji. 



WARNING: TO ENSURE PROPER 
DISK CONTENTS, THE SYSTEM 
SHOULD BE INACTIVE WHILE 
RUNNING THIS UTILITY 



L.XJLJl.a.JL«UJLJ,Xa.JLJi.a.JI.J,JLXXXJ.>J.XJ.Jt. 



SAVE OPTIONS: 

1 = DEVICE 

2 = VOLUME 

3 = DATA SET 
k = EXIT 

ENTER SAVE OPTION: 1 
DISK lODA IN HEX(HH): 



CO 



v^ 



TAPE EXPIRATION DATE WILL NOT BE CHECKED PRIOR TO INITIALIZATION 
CONTINUE (Y,N): Y 

INPUT EXPIRATION DATE (YYDDD): 83OO3 
TAPE##00,DEVSAV TAPE INITIALIZED 
(The source tape is automatically initialized and varied online.) 



\y 
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$TAPEUT1 - Tape Management (continued) 

After you enter the necessary parameters, the Stapeuti attempts to load the double-buffered 
utility. 

If you choose automatic initialization mode and $tapeuti is successful in loading the 
double-buffered utility, $tapeuti issues the following messages: 

DEVICE SAVE OF DISK AT ADDRESS OOCO ONTO TAPE TAPE##00,DEVSAV OK? (Y,N): Y 
USE ATTN/CA TO CANCEL THE SAVE 

^ . _ _ . ^ 

If STAPEUTI cannot load the double-buffered utility, it issues the following message and prompts 
you for another command. 

INSUFFICIENT MEMORY TO LOAD DOUBLE-BUFFERED UTILITY 
COMMAND (?): 

STAPEUTI does not attempt to load the single-buffered utility because the single-buffered utility 
does not have the automatic initiahzation capabiUty. 

Note: To have sufficient storage available for the double-buffered utility, we recommend that 
X you load the Stapeuti utility into a full 64K partition. 

"" Nonautomatic Initialization: if you choose nonautomatic initiahzation, you must first 

initiaUze each tape with the it command and then vary each online with the Svaryon operator 
command. 

If stapeuti can load the double-buffered utility, it issues the the following prompt: 



VOLUME RESTORE OF MYVOL FROM TAPE TAPE##00,VOLSAV OK? (Y,N): Y 
USE ATTN/CA TO CANCEL THE RESTORE 



J 
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If $TAPEUT1 cannot load the double-buffered function, it issues a message and attempts to load 
the single-buffered function. 



INSUFFICIENT MEMORY TO LOAD DOUBLE-BUFFERED UTILITY 
LOADING SINGLE-BUFFERED UTILITY 



V- 



-WARNING- NO DATA STREAM CAPABILITY WITH SINGLE-BUFFERED UTILITY 
SAVE/RESTORE TIME MAY BE SIGNIFICANTLY INCREASED 



If it can load the single-buffered function, $tapeuti issues the following messages: 



Note: $TAPEUT1 issues the warning message only if you are using a 4968 tape unit. 

If $TAPEUT1 cannot load the single-buffered utility, it issues return code 70 (indicating that there 
is not enough storage to load the utility) then issues the command (?): prompt. 

Note: To have sufficient storage available for the double-buffered utility, we recommend that 
you load the $tapeuti utility into a full 64K partition. 

Save Process Using Multiple Tapes: if the save process requires more than one tape, 
$TAPEUTl prompts you to mount any additional tapes that may be necessary to complete the 
save. In this example (automatic initialization mode), four tapes are used to save the device. 



REPLY Y WHEN THE NEXT TAPE IS MOUNTED AND TAPE UNIT ONLINE? Y 

TAPE##01,DEVSAV TAPE INITIALIZED 
REPLY Y WHEN THE NEXT TAPE IS MOUNTED AND TAPE UNIT ONLINE? Y 

TAPE##02,DEVSAV TAPE INITIALIZED 
REPLY Y WHEN THE NEXT TAPE IS MOUNTED AND TAPE UNIT ONLINE? Y 

TAPE##03,DEVSAV TAPE INITIALIZED 






Once $TAPEUTl has saved the device, it issues the following message and prompts you for 
another command. 



V 



DEVICE SAVED 
COMMAND (?): 
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TA — Allocate a Tape Data Set: 



Use the ta command to delete an existing data set and reallocate a null data set, or add a null 
data set after the last data set on the volume. 

Notes: 

1 . Use this command to place data set labels on previously initiaUzed standard-labeled (sl) 
tapes; the tape unit must be in the standard label processing mode. 

2. The system destroys all the data on the tape following the newly allocated data set. 

3. You must vary the tape online to the file number of the data set you are allocating. 

4. You must vary the tape online if you want a program to access it. 
Example: Allocate data set (DATA2222) on volume 123456. 



COMMAND (?): TA 

TAPEDS (NAME, VOLUME): DATA2222 , IZS'+Se 
EXPIRATION DATA (YYDDD): 79001 
DATA SET ALLOCATED 

, COMMAND (?): 
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$TERMUT1 - Change Terminal Parameters 

$TERMUT1, a general-purpose terminal utility program, alters logical device names, address 
assignments, or terminal configuration parameters. Changes you make remain in effect until you 
reinitialize the system. 

Invoking $TERMUT1 

Invoke $TERMUTl with the $L operator command or option 3.10 of the session manager. 

$TERMUT1 Commands 

To display the $termuti commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



o 



COMMAND (?): ? 

LA -- LIST TERMINAL ASSIGNMENTS 

RE -- RENAME 

RA -- REASSIGN ADDRESS 

RH -- REASSIGN HARD COPY 

CT -- CONFIGURE TERMINAL 

ON -- VARY TERMINAL ON 

OF -- VARY TERMINAL OFF 

EN -- END PROGRAM 

COMMAND (?): 



After $TERMUTl displays the commands, it prompts you again with command (?):. Then you 
can respond with the command of your choice (for example, la). Each command and its 
explanation is presented in alphabetical order on the following pages. 






CT — Configure Terminal 



Use the CT command to modify the page-formatting parameters associated with a terminal, but 
be sure you turn on the printer. If you don't, any changes you made will not take effect and 
$termuti enters a wait state. You must then turn the printer on and reenter the CT command. 
With CT, you can also designate a terminal as a printer, temporarily, for spooUng output. 

CT allows you to do some of the same things as the termctrl function. When you specify the 
CT command, the system issues questions for the various parameters of the terminal. $termuti 
checks the terminal name to see if it is a 4975-OlA, 4975, 5219, 5224, or 5225. If the device is 
one of these printers, the system asks additional questions relating to their extended functions. 
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$TERMUT1 - Change Terminal Parameters (continued) 






When you change the charset parameter, it has the same effect as if you had coded it on the 
TERMINAL Statement. 

Any parameters changed by the $TERMUTl CT command become permanent values until you 
change them again with another CT command or another termctrl statement. 

The following examples show the conditional prompt message associated with each parameter 
for the 4973, 4974, and 4975-OlA; for the 3101 (block mode); for the 4975 models 1 and 2, 
5219, 5224, and 5225. 

Once you assign values for these parameters, you can change them by issuing the CT command 
again. The CT command displays the values that currently are defined in the NOW is ' ' portion 
of the prompt, and you can change or delete the values that you no longer need. If you don't 
want to change a given value, press the enter key and the system will not change the value. 

CT first prompts you for the terminal name. Enter * to specify the terminal where you are 
assigned at present or enter the name of another terminal you wish to modify. 

Example 1 : Reconfigure a 4973 or 4974 printer. 

> SL $TERMUT1 

LOADING STERMUTl B'tP ,01 :05 :00, LP= 2600, PART=1 

""" TERMINAL CONFIGURATOR """ 

COMMAND (?): CT 

ENTER TERMINAL NAME: SSYSPRTR 



PAGE SIZE 
TOP MARGIN 
BOTTOM MARGIN 
HISTORY LINES 
LEFT MARGIN 
RIGHT MARGIN 



(NOW IS 2^+): 

(NOW IS 0): 

(NOW IS 23): 

VALUE 
(NOW IS 12): 



VALUE 
VALUE 



(NOW IS 0): 
(NOW IS 79) 



OVERFLOW LINES (NOW IS N) 

OUTPUT PAUSE (NOW IS Y) 

SPOOLABLE (Y/N) (NOW IS N) 

LPI (6/8) (NOW IS 8) 



VALUE 
VALUE 
VALUE 
VALUE 
VALUE 



NOT CHANGED 

NOT CHANGED 

NOT CHANGED 

NOT CHANGED 

NOT CHANGED 

NOT CHANGED 

NOT CHANGED 

NOT CHANGED 
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Note: If your terminal is a 4975-OlA ASCII printer, the prompts are identical to those in 
example 1 except for lpi (lines-per-inch). For a 4975-OlA ASCII printer, the system does not 
prompt you for lpi. 

If your terminal is a 3101 (block mode), CT prompts you as follows: 

Example 2: Reconfigure a 3101 display terminal (block mode). 



OVERFLOW LINES (NOW IS N) 

OUTPUT PAUSE (NOW IS N) 

SPOOLABLE (Y/N) (NOW IS N) 

VALUE NOT CHANGED 
ATTRIBUTE (H I GH/LOW/BL I NK/BLANK/NO) : (NOW IS HIGH) 



VALUE NOT CHANGED 
VALUE NOT CHANGED 



V. 



STREAM (Y/N)?: (NOW IS N) 
COMMAND (?): 



VALUE NOT CHANGED 
VALUE NOT CHANGED 



With the option SPOOLABLE, you can temporarily designate a terminal as a printer for spooling 
output. CT prompts you as follows with the current status of the terminal displayed. 

I SPOOLABLE (Y/N) (NOW IS _) : 

If you respond Y, you may specify the designated terminal as a spool device by using the 
$SPLUTl utility. If you respond N, the system resets the terminal's status and you may not 
designate the terminal as a spool device with the $spluti utility. If you do not want to change 
the spoolable status of the device, press the enter key and the system will not change the status. 

The operation of a terminal you specified as a spoolable device is not affected until you 
designate the device as a spool device using the $spluti utility and the system activates 
spooling. Once the system activates spooling, it dedicates the device to spooling until the spool 
function ends. For a description of spooling to devices other than IBM printers, see the Event 
Driven Executive Language Programming Guide. 

Note: You may get unpredictable results if you change the spoolable status of a terminal while 
spooling is active on that terminal. 

The option output pause allows you to disable the "screen full" pause for screen devices so 
that unattended systems do not enter an indefinite wait state. 



o 
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$TERMUT1 - Change Terminal Parameters (continued) 

Note: For more information on terminal parameters, see the terminal statement in the 
Installation and System Generation Guide. 

Because the 4975 model 1, 5219, 5224, and 5225 printers do not support text mode, the system 
does not issue the print mode (pmode) prompt for these printer models. You may not specify 
PDEN=cOMP for a 4975 model 1 printer. 

If your terminal is a 4975 model 1, 5219, 5224, or 5225 printer, CT prompts you as follows: 

Example 3: Reconfigure a 4975 model 1, 5219, 5224, or 5225 printer. 

PDEN (EXPD/NORM/COMP) (NOW IS EXPD) : 

VALUE NOT CHANGED 
CHARSET {? FOR LIST) (NOW IS USCA) : 

VALUE NOT CHANGED 

COMMAND (?): 

If your terminal is a 4975 model 2, CT prompts you as follows: 
Example 4: Reconfigure a 4975 model 2 printer. 

PDEN (EXPD/NORM/COMP) (NOW IS EXPD) : 

VALUE NOT CHANGED 
PMODE (DRAFT/TEXTl/TEXT) (NOW IS TEXT) : 

VALUE NOT CHANGED 
CHARSET (? FOR LIST) (NOW IS USCA) : ? 
INTL USCA AUGE BELG 
BRZL FRCA DNNR SWF I 
FRAN ITAL JAEN KANA 
PORT SPAN SPNS UK I N 

CHARSET (? FOR LIST) (NOW IS USCA) : INTL 

COMMAND (?): 
^ J 
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EN — End $TERMUT1 

Use the en command to end the $termuti utility. 
Example: End $TERMUT1. 



COMMAND (?): EN 

$TERMUT1 ENDED AT 08:36:02 






LA — List Terminal Assignments 



Use the la command to list the current terminal names, addresses, types, assigned partitions, 
hard-copy terminals, and virtual terminal connections, if applicable. An arrow on the left side of 
the listing identifies the terminal that invoked $termuti. 

Example: List terminal assignments. 



> $L $TERMUT1 

LOADING $TERMUT1 34P ,01 :05 : 20, LP= 2600, PART=1 

""" TERMINAL CONFIGURATOR """ 

COMMAND (?): LA 



NAME 



ADDR 



TYPE 



PART HARD-COPY ONLINE 



PRTRl 


58 
59 
5A 
5B 
Qk 
Ik 
21 
01 
68 

•k-k 


it975-02R 

MFA 3101 

4975-OlL 

4975-02L 

4979 

4978 

4973 PTR 

4974 PTR 
FPCA 4/L 
VIRT 


1 

4 
1 

1 




YES 




ACCA3101 

PRTR2 

PRTR3 




YES 
YES 
YES 


(3101 BLOCK MODE) 


$SYSLOG 


2 
3 

1 
1 

2 
1 


MPR INTER 
PRTRl 


YES 




===>$SYSLOGA 
$SYSPRTR 


YES 
YES 




MPR INTER 

ACCA68 

CDRVTA 


YES 
YES 
YES 


(3101 BLOCK MODE) 
CONNECTED CDRVTB 




■k-k 


VIRT 


SYNC-YES 




1 






CDRVTB 


YES 


CONNECTED CDRVTA 










COMMAND {?): 
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$TERMUT1 - Change Terminal Parameters (continued) 



OF — Vary a Terminal Offline 



Use the OF command to vary a terminal offline. When you vary a terminal offline, the system 
ignores any input from that terminal. If you send output to a terminal that is offline, the system 
issues a return code of 5 "device not ready". 

Note; If you vary offline the base address of a 2091/92 card (multiline acca) or a 2095/96 
card (feature programmable communications adapter), any other addresses serviced by that card 
become unusable. 

Example 1: Vary offline the terminal designated as the alternate logging device. 



COMMAND (?): OF 

ENTER TERMINAL NAME, OR ADDRESS IN (): SSYSLOGB 

TERMINAL SUCCESSFULLY VARIED OFF 

COMMAND (?): 






If you issue the OF command to a terminal that is in use, CT issues a prompt asking if you wish to 
continue or end the command. If you choose to continue, normal processing of the program 
which was using the terminal is not guaranteed. 

Example 2: Vary the alternate logging device, which is currently in use, offline. 



COMMAND (?): OF 

ENTER TERMINAL NAME. OR ADDRESS IN (): SSYSLOGB 

WARNING - TERMINAL IN USE 
CONTINUE VARYOFF PROCESSING? Y 

TERMINAL SUCCESSFULLY VARIED OFF 

COMMAND (?): 



J 
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$TERMUT1 - Change Terminal Parameters (continued) 

If you issue the OF command to the terminal that you are using, CT issues a prompt asking if you 
wish to continue or end the command. If you choose to continue, the utility ends after the 
VARYOFF completes. 



C' 



Example 3: Vary offline the terminal you are using. 



COMMAND (?): OF 

ENTER TERMINAL NAME, OR ADDRESS IN 

WARNING - TERMINAL IN USE 
CONTINUE VARYOFF PROCESSING? Y 

TERMINAL SUCCESSFULLY VARIED OFF 

COMMAND(?): 



SSYSLOGB 



ON — Vary a Terminal Online 



Use the ON command to vary a terminal online. When the varyon process completes, the 
terminal can send and receive interrupts. 

For any terminal connected to an ACCA-type card, you must send a message to the terminal 
before it is fully enabled for regular processing. Use the list supervisor configuration command 
(ls) of the $iOTEST utility to determine which terminals are connected to an ACCA-type card. 
To send a message to a terminal, use the $termut3 utility. 

Example: Vary online the terminal at address 68. 






COMMAND (?): ON 

ENTER TERMINAL NAME, OR ADDRESS IN {) 

TERMINAL SUCCESSFULLY VARIED ON 

COMMAND(?): 



(068) 






J 



o 
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$TERMUT1 - Change Terminal Parameters (continued) 



RA — Reassign Address 



Use the RA command to reassign the address specified in the address = parameter of the 
TERMINAL Statement. The syntax of this command is: 



RA name address 



where the address in question must be unassigned currently. 

As shown in the following examples, the name can be a logical name or hexadecimal device 
address. If you indicate a device address, it must consist of 1 or 2 digits enclosed in parentheses. 



Example: 



RA 


DISPLAY2 


7 


RA 


$SYSPRTR 


12 


RA 


(05) 06 





RE — Rename Logical Device 






Use the RE command to rename the logical terminal name (the label on the terminal 
statement) that you specified during system generation. The form for this function is: 



RE oldname newname 



The new name replaces the old name. As shown in the following examples, the old name can be 
a logical name or a hexadecimal device address. If you indicate a device address, it must consist 
of 1 or 2 digits enclosed in parentheses. Use the la command to verify the changes. 



Example: 



RE DISPLAY2 .DISPLAYS 
RE (06) TERM1 
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$TERMUT1 - Change Terminal Parameters (continued) 

RH — Reassign Hard-Copy 

Use the rh command to change the hard-copy device associated with a 4978, 4979, or 4980 
display station and to indicate which program function key you want to use for the hard copy. 
The form is: 



,.r^ 



RH name keycode 



Here, "name" is the logical name (not device address) of the hard-copy device, and "keycode" 
is the code for the desired hard-copy key (for example, 1 to 6 for the 4979 display). 

The system changes the hard copy device for the terminal from which you loaded $termuti. 

Example: 



RH 


$SYSLOGA 


6 


RH 


$SYSLOGA 


4 


RH 


PRTR2 6 





'\,J 
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$TERMUT2 - Change Image/Control Store 

You can use $termut2 to: 

• Restore the image buffer of a 4974 printer to the standard 64-character set. 

• Load the image buffer of a 4974 with the 96-character set $4974isi. Appendix B of 4974 
Printer Description, GA34-0025, includes a description of the 96-character set. 

• Assign a define key in a 4978 control store. 
Note; The 49^0 has a permanent define key. 

• Change the definition of one or more keys in a 4978 or 4980 control store. 

• Load a 4978 or 4980 control store from a direct-access data set or save a newly redefined 
4978 or 4980 control store into a direct-access data set. 

• Load a 4978 or 4980 image store from a direct-access data set or save a 4978 or 4980 image 
store into a direct-access data set. Refer to the description of the $FONT utility program for 
a description of image store definition. 

• Completely load a 4980 terminal. 

You may wish to invoke these functions from a terminal other than the one you are using; 
therefore, the system prompts you to specify a terminal. If the selected terminal is not a 4974, 
4978, or 4980, the system notifies you and rejects the command. 



4974 Support 



Use $TERMUT2 to restore the image buffer of a 4974 printer to the standard 64-character set or 
to load the 96-character set image $4974isi. The 4974 printer uses the Extended Binary Coded 
Decimal Interchange Code (EBCDIC), which includes 64 standard characters and five characters 
for international use (96 characters are available with $4974lSl). You can change the standard 
key definition by using the termctrl instruction within your application program or using the 
$FONT utility, and the system stores the redefined character set in the image buffer of the 4974. 
For detailed information on the 4974 printer, refer to the Bibliography for the 4974 Printer 
manual. 



4978 and 4980 Support 



Use $TERMUT2 to make special character string assignments on the 4978 and 4980 keyboard. 
The system defines the functional characteristics of a keyboard by data tables in the 
system-supplied data sets. These tables vary according to the particular keyboard used and are 
provided on an ibm diskette shipped with your keyboard. The tables contained on the diskette 
are of two types: 

• Control data 

• Image data. 



CJ 
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$TERMUT2 - Change Image/Control Store (continued) 

Control data consists of scan-code-translation tables and a redefine table. Image data consists 
of a character-image table. 

4978 and 4980 displays have a control store and an image store, loaded from disk or diskette. 
At IPL, the system automatically loads all 4978s and 4980s with the following control-store and 
image-store data sets: 



o 



Display 
Station 


Control 
Store 


Image 
Store 


4978 


$4978CS0 


$4978180 


4980 


$4980CS0 


$4980180 



These control/image stores may be standard system-supplied data sets or control/image store 
data sets that you created and named $4978CS0 and $4978180 for the 4978 and $4980CS0 and 
$4980180 for the 4980. 

Key definitions can be changed, perhaps to be appropriate to a special key data appUcation, and 
the redefined keyboard definitions saved on disk. The keyboard definition can be reloaded later 
using $TERMUT2 or by using the termctrl instruction within your application. When the tables 
are altered, it is not necessary to alter the entire table. Your particular application may be 
enhanced through minor changes in key functions on a temporary or permanent basis. Use 
$FONT to change the display image of redefined keys. Refer to the Operation Guide for 
procedures on how to define an interrupt key on a 4978 or 4980. 

For detailed information on the 4978 or 4980 display station functions and the 4978 or 4980 
keyboards, refer to the Bibliography. 



xJ 



Data Set Names and Requirements 



Depending on the type of display stations that are attached to your Series/ 1, two special names 
are reserved by the system and used during initial program load time. For the 4978 and 4980 
display stations, the two special data sets are as follows: 



Display 
Station 


Control 

Store 

Label 


Image 
Store 
Label 


4978 


$4978080 


$4978180 


4980 


$4980080 


$4980180 



These data sets are automatically searched for and loaded to defined display stations during the 
initiaUzation phase at IPL time. After IPL, $TERMUT2 can be used to load a control or image store 
from control/image data sets you have defined, or to read the control or image store in a 
display, and write to a data set you have allocated. 

For each control store or image store that you create and wish to save, $termut2 requires 
preallocated data sets. For the 4978, the sizes of the data sets are as follows: 

1 . A 1 6-record (4096 bytes) data set for each control store 

2. An 8-record (2048 bytes) data set for each image store. 
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$TERMUT2 - Change Image/Control Store (continued) 

For the 4980, the sizes of the data sets are as follows: 

1. An 8-record (2048 bytes) data set for each control store 

2. A 16-record (4096 bytes) data set for each image store 

Names for the image and control stores respectively are $4980ISx and $4980CSx, where 'x' is 
any character excluding through 9 which are reserved by edx. 

Invoking $TERMUT2 

You invoke $termut2 with the $l operator command or option 4.2 of the session manager. 

$TERMUT2 Commands 

To display the $termut2 commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?):. 

> $L $TERMUT2 

LOADING $TERMUT2 3^P ,01 :07 :09 , LP= 9200, PART=1 

COMMAND (?): ? 

AD - ASSIGN DEFINE KEY 

C - CHANGE KEY DEFINITION 

EN - END PROGRAM 

LC - LOAD CONTROL STORE 

LI - LOAD IMAGE STORE 

LT - LOAD 4980 TERMINAL 

RE - RESTORE k37k TO STANDARD 64-CHARACTER SET 

SC - SAVE CONTROL STORE 

SI - SAVE IMAGE STORE 

COMMAND (?): 

After $TERMUT2 displays the commands, you are again prompted with COMMAND (?):. Then you 
can respond with the command of your choice (for example, ad). 
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$TERMUT2 - Change Image/Control Store (continued) 

AD — Assign a Define Key 

Use the AD command to predefine a key that causes the 4978 attachment to enter define mode 
and allows you to assign a function or a series of functions to a specific key. For example, if you 
wanted to use key number 66 (0 in Figure 35 on page UT-563 ), find that number in 
Figure 37 on page UT-564 (0) and make note of its scan code, in this case 20. The 4980 has a 
predefined define key that you may want to use instead of the AD command. For a 
step-by-step explanation of this procedure, refer to "Chapter 3" of the Operation Guide. 

Note: The 4980 has a predefined define key. 

Syntax: 



AD 



number terminal 



Required: ALL 
Default: none 



Operands Description 

number Hexadecimal number of the key assigned as the DEFINE key. 

terminal The name of the terminal whose control store you are modifying. Pressing the * 

enter key (CR=carriage return) or entering an * and pressing the enter key specifies 
the terminal that you used to invoke $TERMUT2. 



..:-)i 



Example: Assign a define key. 



COMMAND (?): AD 

ENTER SCAN CODE OF KEY TO BE ASSIGNED 

AS THE DEFINE KEY (HEX): 20 
ENTER TERMINAL NAME (CR OR * = THIS ONE): 



SSYSLOG 



V 



ENTER NONSHIFT, SHIFT, OR ALTERNATIVE CODE MODE (N/S/A): N 



J 



Note: The N/S/A options will appear only on the 4980. 



c 
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$TERMUT2 - Change Image/Control Store (continued) 



C — Change a Key Definition 



Use the c command to change the function id, local character, or interrupt code of a key to 
another definition on the terminal you specify. For a step-by-step explanation of this procedure, 
refer to "Chapter 3" of the Operation Guide. 

Syntax: 



terminal key id char interrupt 



Required: ALL 
Default: none 



Operands Description 

terminal The name of the terminal whose control store you are modifying. Press the enter 

key (CR= carriage return) or enter an * and press the enter key to specify the 
terminal that you used to invoke $TERMUT2. 

key Defines the key (in hexadecimal) you want to redefine. 

id Defines the new function of the key (in hexadecimal). 

char Defines the EBCDIC code (in hexadecimal) used to print the character on the 

screen. 

interrupt Defines the key (in hexadecimal) as an interrupt key or a character. 

Notes: 

1 . The decimal and hexadecimal values associated with the interrupt key code are reduced by 
your system. These values decrease by the number specified for the PFi key during system 
generation. If you used the default value for PFi at system generation it decreases by 1, the 
default. To verify the system code use the $pfmap utility. Note that values for the interrupt 
code have been reduced by the value specified for PFl at system generation. 

2. You can find a partial listing of the scan code, function ID code, character/function code, 
and interrupt code for the 4978, prpq D02056 in Figure 37 on page UT-564 and for the 4980 
in Figure 38 on page UT-565. For a complete listing, see the general information manuals 
for the 4978 keyboard or the 4980 display station. 
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$TERMUT2 - Change Image/Control Store (continued) 



Example: Change a key definition. 



COMMAND (?): C 

ENTER TERMINAL NAME (CR OR * = THIS ONE): $SYSLOG 

ENTER SCAN CODE OF THE KEY TO BE REDEFINED (HEX): 01 

ENTER NONSHIFT, SHIFT, OR ALTERNATIVE CODE MODE (N/S/A) 

ENTER NEW FUNCTION ID (HEX): 20 

ENTER NEW CHARACTER/FUNCTION CODE (HEX): 00 

ENTER NEW INTERRUPT CODE (HEX): 01 

ANOTHER KEY? N 



Note: The N/S/A options will appear only on the 4980. 
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$TERMUT2 - Change Image/Control Store (continued) 
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Figure 35. 4978 Display Station keyboard 




Figure 36. 4980 Display Station 
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Figure 37. Control Chart for 4978 Display Station 
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$TERMUT2 - Change Image/Control Store (continued) 
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Figure 38. Control Chart for 4980 Display Station 
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$TERMUT2 - Change Image/Control Store {continued) 

EN — End Program 

Use the EN command to terminate the $TERMUT2 utility. 

Syntax: 



EN 

Required: none 
Default: none 



Operands Description 

None 

Example: End the $termut2 utility. 



COMMAND (?): EN 
$TERMUT2 ENDED 



V 



^^ 
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$TERMUT2 - Change Image/Control Store (continued) 

LC — Load a Control Store 

Use the LC command to load the control-store data set into the terminal specified. 

Syntax: 



LC name,volume terminal 

Required: ALL 
Default: none 



Operands Description 

name Defines the name of the data set to be accessed. 

volume Defines the name of the volume containing the data set. 

terminal Defines the name of the terminal that loaded the data set; press the enter key 

(CR= carriage return) or enter an * and press the enter key to specify the terminal 
that invoked $termut2. 

Example: Load a 4978 control store. 

COMMAND (?): LC 

FROM DATA SET (NAME .VOLUME) : ^iigyBCSO ,EDX002 
ENTER TERMINAL NAME (CR OR " = TH I S ONE): * 
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$TERMUT2 - Change Image/Control Store (continued) 

LI — Load an Image Store 

Use the li command to load an image store (character image table) on the terminal specified. 
Syntax: 






LI name,volume terminal 

Required: ALL 
Default: none 



Operands Description 

name Defines the name of the data to be accessed. 

Defines the name of the volume containing the data set. 



volume 
terminal 



Defines the name of the terminal that loaded the data set; press the enter key 
(CR= carriage return) or enter an * and press the enter key to specify the terminal 
that invoked $termut2. 



Example 1: Load a 4978 image store. 



COMMAND (?): LI 

FROM DATA SET (NAME .VOLUME) : $4978 I S0,EDX002 
ENTER TERMINAL NAME (CR OR * = THIS ONE): " 






Example 2: Load a 4974 image store. 



COMMAND (?): LI 

FROM DATA SET (NAME .VOLUME ) : $^97^ I S 1 ,EDX002 
ENTER TERMINAL NAME (CR OR * = THIS ONE): MPRINTER 



\fcV 
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$TERMUT2 - Change Image/Control Store (continued) 



LT — Load 4980 Terminal 



You can use the LT command to complete loading of a 4980 terminal. If you did not include the 
power-on support for the 4980 and your 4980 gets powered off, you can bring it back up again 
by using the LT command. 

Syntax: 



LT 



terminal 



Required: terminal 
Default: none 



Operands Description 

terminal Defines the 4980 you want to load. 

Example: Load a 4980 terminal. 



COMMAND (?): LT 

ENTER TERMINAL NAME (CR OR * = THIS ONE): TERMl 

CURRENT IMAGE STORE DATA SET NAME IS $i»980ISX 

SYSTEM DEFAULT DATA SET IS $'♦980 ISO 

ENTER LAST CHARACTER OF DATA SET NAME TO BE USED: 

CURRENT CONTROL STORE DATA SET NAME IS $i»980CSX 

SYSTEM DEFAULT DATA SET NAME IS $4980CS0 

ENTER LAST CHARACTER OF DATA SET NAME TO BE USED: 

LOADING IMAGE STORE AND CONTROL STORE TO TERMl 

SUCCESSFUL COMPLETION OF '♦980 LOAD 

COMMAND (?): 
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$TERMUT2 - Change Image/Control Store (continued) 

RE — Restore 4974 to Standard 64-Character Set 

Use the RE command to restore the image buffer of a 4974 printer to the standard 64-character 
set. 

Syntax: 



RE terminal 

Required: terminal 
Default: none 



Operands Description 

terminal Defines the device to be restored. 

Example: Restore 4974 to standard 64-character set. 



COMMAND (?): RE 

ENTER TERMINAL NAME (CR OR " = THIS ONE): MPR INTER 
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$TERMUT2 - Change Image/Control Store (continued) 

SC — Save a Control Store 

Use the SC command to save a redefined control store in the data set specified. 

Syntax: 






SC nanne,volume terminal 

Required: ALL 
Default: none 



Operands Description 

name Defines the name of the data set to be saved. 

volume Defines the name of the volume where the data set is to be saved. 

terminal Defines the name of the terminal issuing the save; press the enter key (CR=carriage 
return) or enter an * and press the enter key to specify the terminal that invoked 

$TERMUT2. 

Example: Save a control store. 

COMMAND (?): SC 

SAVE DATA SET (NAME .VOLUME) : Si4978CS0,EDXOO2 
ENTER TERMINAL NAME (CR OR " = THIS ONE): $SYSLOG 

v. y 
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$TERMUT2 - Change Image/Control Store (continued) 

SI — Save an Image Store 

The SI command saves a redefined image store in the data set specified. 

Syntax: 



SI name, volume terminal 

Required: ALL 
Default: none 



Operands Description 

Defines the name of the data set being saved. 

Defines the name of the volume where the data set is to be saved. 



name 

volume 

terminal 



Defines the name of the terminal issuing the save; press the enter key (CR=carriage 
return) or enter an * and press the enter key to specify the terminal that invoked 

$TERMUT2. 



Example: Save an image store. 



COMMAND (?): SI 

SAVE DATA SET (NAME .VOLUME ) : 5^*978 I SO ,EDX002 
ENTER TERMINAL NAME (CR OR *=THIS ONE): SSYSLOG 






1^ 
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$TERMUT3 " Send Message to a Terminal 



$TERMUT3 sends a single-line message from your terminal to any other terminal defined in the 
system. One message line is sent at a time and you are prompted for the message and the 
terminal where the message is to be sent, and if additional messages are to be sent. 



Invoking $TERMUT3 



Invoke $termut3 with the $L operator command or option 4.3 of the session manager. 
$TERMUT3 does not have commands and only issues prompting messages as follows: 



c 



V 



> $L $TERMUT3 

LOADING $TERMUT3 ^tP ,01 lOSr'iO, LP= 9200, PART=1 

TERMINAL BROADCAST UTILITY 

ENTER TERMINAL NAME: 

(Label of the terminal to which message is to go.) 

ENTER MESSAGE TO SEND 

(Type in message and press the ENTER (CR) key. 

The message is transmitted to the destination terminal.) 

ANOTHER MESSAGE (Y/N)? 

(If yes, you are prompted to enter another message line.) 

ANOTHER TERMINAL (Y/N)? 

(If yes, select another terminal and repeat the above process.) 

DETACH PROGRAM, (WAIT FOR 'ATTN SEND') (Y/N)? 
(If yes, the program remains loaded and inactive. 
Pressing the ATTN key and entering 'SEND' starts 
the above process again.) 



J 
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$TERMUT3 - Send Message to a Terminal (continued) 



Example 1 : Send a message to terminal $sysloga. 



\J 



> SL $TERMUT3 

LOADING $TERMUT3 3P.OO:4l:10, LP= 8800 

TERMINAL BROADCAST UTILITY 

ENTER TERMINAL NAME: $SYSLOGA 
ENTER MESSAGE TO SEND 
THIS IS A TEST MESSAGE. 

ANOTHER MESSAGE (Y/N)? Y 

ENTER MESSAGE TO SEND 

THIS IS ANOTHER TEST MESSAGE. 

ANOTHER MESSAGE (Y/N)? N 

ANOTHER TERMINAL (Y/N)? N 

DETACH PROGRAM, (WAIT FOR 'ATTN SEND') (Y/N)? N 

$TERMUT3 ENDED AT 00:^13:05 



Example 2: Select another terminal after sending a message. 

r \ 

ANOTHER MESSAGE (Y,N)? N 

ANOTHER TERMINAL (Y/N)? Y 
ENTER TERMINAL NAME: SSYSPRTR 
ENTER MESSAGE TO SEND 
HELLO $SYSPRTR 

ANOTHER MESSAGE (Y/N)? N 

ANOTHER TERMINAL (Y/N)? N 

DETACH PROGRAM, (WAIT FOR 'ATTN SEND') (Y/N)? N 

$TERMUT3 ENDED AT 00:5^:00 



''1-=J»' 



J 
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$TERMUT3 - Send Message to a Terminal (continued) 



Example 3: Keep $termut3 active, send a message later. 



ANOTHER MESSAGE (Y/N)? N 

ANOTHER TERMINAL (Y/N)? N 

DETACH PROGRAM, (WAIT FOR "ATTN SEND') (Y/N)? Y 

> SEND 

ENTER TERMINAL NAME: TTY30 
ENTER MESSAGE TO SEND 
TTY30 - ARE YOU THERE 

ANOTHER MESSAGE (Y/N)? N 

ANOTHER TERMINAL (Y/N)? N 

DETACH PROGRAM, (WAIT FOR 'ATTN SEND') (Y/N)? Y 
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$TRACEIO - ACCA/EXIO Trace Facility 



The $TRACElo Utility will trace the activities of one device attached through an ACCA or EXIO 
attachment. $traceio is only capable of tracing the activities on a device (one address) . 
Therefore, you must invoke the $traceio utility for each device you want to trace. Multiple 
traces require multiple loads, one for each address. 






$TRACEio uses an internal buffer (storage area) to record events as they occur. You can 
increase or decrease the size of the buffer by using the set storage (ss) command of $diskut2. 



Invoking $TRACEIO 



You invoke $traceio with the $L operator command. The session manager does not support 
this utiUty. 



> $L STRACEIO 
LOADING $TRACEIO 

COMMAND (?): 



55P, 03:29:58, LP= 0000, PART= 2 



STRACEIO Commands 



To display the $traceio commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



COMMAND (?): ? 

Dl - DISPLAY TRACE DATA SET 

DU - DUMP TRACE BUFFER 

EN - END TRACE 10 PROGRAM 

RE - REPEAT PREVIOUS TRACE 

TR - TRACE COMMUNICATIONS LINE 



^ 



COMMAND (?) 



y 



^'*u.. 



After STRACEIO displays the commands, it prompts you with command (?): again. Then you can 
respond with the command of your choice (for example, tr). 

To use STRACEIO, you should start out with the tr command and set up the trace for a specified 
communications hne. 

Each command and its explanation is presented in alphabetical order on the following pages. 



""^i 
K^' 
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$TRACEIO - ACCA/EXIO Trace Facility (continued) 



Dl — Display Trace Data Set 



Use the Di command to display the contents of the trace data set on the device specified. You 
have the option of monitoring lO instruction executions (oio) and/or interrupts. You can 
display the contents on the terminal where you are working currently or direct the contents to 
any device you specify. 

Example: Display contents of the trace data set on myprtr. 



COMMAND (?): Dl 

TRACE DATA SET (NAME .VOLUME) : 
DISPLAY 010 EXECUTIONS (Y/N)? 
DISPLAY INTERRUPTS (Y/N)? Y 
ENTER PRINTER NAME: $MYPRTR 
ARE ALL PARAMETERS CORRECT (Y/N)? 



$TRACEDS,EDX002 
Y 



DU — Dump Trace Buffer 



Use the DU command to dump the contents of the trace buffer. You have the option of 
monitoring lo instruction executions (oio) and/or interrupts. You can also display trace 
progress data on a terminal or printer and/or log to a disk(ette) data set previously allocated 
using the allocate (al) command of the $diskuti utility. 

$TRACEio prompts you to determine what you want to do with the trace data set in the 
$TRACEio data buffer. You can display, log, or print the data to disk(ette), or you can do any 
combination of the three. 

Example: In this example, the contents of the $TRACEiO data buffer are to be printed on the 
system printer and also saved in a data set named $traceds. 

COMMAND (?): DU 

DISPLAY OIO EXECUTIONS (Y/N)? Y 
DISPLAY INTERRUPTS (Y/N)? Y 
PRINT TRACE DATA? Y 
ENTER PRINTER NAME: $SYSPRTR 
LOG TO DISK(ETTE) (Y/N)? Y 
ENTER TRACE DATA SET NAME, VOLUME; 



$TRACEDS,EDX002 



ARE ALL PARAMETERS CORRECT (Y/N)? Y 



Sample output displayed on the monitoring terminal/printer would appear as in following 
example. 



,i#^ 
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$TRACEIO - ACCA/EXIO Trace Facility (continued) 



$TRACEIO MONITOR OF ACCA LINE AT ADDRESS -■ 


- 08 


TDAPC RATA CCT 






- $TRACEDS,EDX002 


IKMl/t UAIM Ot 1 






EXECUTE RESET 010 


CC=7 






EXECUTE START 010 


CC=2 






EXECUTE START 010 


CC=2 






EXECUTE START 010 


CC=7 






INTERRUPT 


ICC=2 (EXCEPTION) 






ISB=AO 








DEVICE-DEPENDENT 


STATUS AVAILABLE 




WRONG LENGTH RECORD 




DCB 








CONTROL WORD 


2004 


(INPUT RECEIVED) 




TIMER 1 


0002 






TIMER 2 


OOOA 






CHAIN ADDR 


0000 






BYTE COUNT 


0008 






DATA ADDR 


1A4E 




EXECUTE SCSS 010 


CC=7 






INTERRUPT 


ICC=3 (DEVICE END) 






STATUS WORD 


1A54 


RESIDUAL ADDR 




1 


0000 


FLAG WORD !■ 




2 


FitOO 


FLAG WORD 2 






DTR 


ON 






DSR 


ON 






RTS 


ON 






CTS 


ON 






RECEIVE MODE 



) 



-if 

V 



For ACCA devices, status words are interpreted via messages derived from the bit-significant 
data contained in the ess words 1 and 2. EXio status words may also be 
displayed/printed/logged. However, with EXiO devices, the hardware type is unknown to the 
software. You must be very familiar with the device in order to use the EXio support. 
Therefore, you must interpret the results of the EXio ess words. 

EN — End $TRACEIO Utility 

The EN command terminates the $traceio utility. 



Example: End $traceio utility. 



COMMAND (?): EN 

STRACEIO ENDED AT 00:00:00 
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_^ $TRACEIO - ACCA/EXIO Trace Facility (continued) 

RE — Repeat Previous Trace 

Use the RE command to repeat the trace previously performed on a communications line. 

Example: 



L 



COMMAND (?): RE 



TR — Trace Communications Line 

You can use the tr command to trace the activities on a specific communications Une. 

When you enter TR, $traceio prompts you for the address of the line to be traced. 

COMMAND (?): TR 

ENTER HEX ADDRESS OF LINE TO BE TRACED: 



•x 



i 



If the device at the specified address is not traceable, $traceio issues the following message: 



I 



TRACE OPTION NOT SELECTED AT SYSGEN 



If the device at the specified address is not an ACCA or EXIO device (defined with the terminal 
or EXIO definition statements, respectively), $TRACEiO issues the following message- 

INVALID ADDRESS 
RETRY (Y/N)? 
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$TRACEIO - ACCA/EXIO Trace Facility (continued) 



If the device is valid, $traceio automatically adjusts itself to the type of device handler to 
which it is attached. As a result, you are not required to specify the device type. After verifying 
that the device is on a traceable line, $traceio modifies the ccb/ddb to point to the immediate 
action address (flih) in the include module traceio. $traceio then prompts you to specify 
one or a combination of the following terminating condition(s): 



oio count 

interrupt count 

end-of-buffer 

a specific PF key 

a combination of these conditions 



TERMINATE ON FULL BUFFER? 

TERMINATE ON COUNT? 

010 COUNT OR ZERO: 

INTERRUPT COUNT OR ZERO: 

ARE ALL PARAMETERS CORRECT (Y/N)? 

NOTE: $TRACEIO MAY BE TERMINATED AT ANY TIME WITH PF3 



If you do not specify end-of-buffer as a terminating condition, the trace buffer wraps on a 
full-buffer condition as necessary until a specified termination condition (count or pf key) 
occurs. The first occurrence of any specified termination condition ends the trace regardless of 
whether other specified criteria have been met. 

Interrupts and their condition codes, ISB, and DCB information are recorded. Attempts to 
execute I/O instructions and their resulting immediate conditions are also recorded. When a 
device end interrupt from a start cycle steal status (scss) instruction is received, the status words 
are records. 
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$TRANS - Transmit Data Sets Across a Bisync Line 



Load $TRANS in order to transmit edx data sets and programs from one Series/ 1 to another 
across a point-to-point bisynchronous communication line. 



Invoking $TRANS 



Invoke $trans first on the receive end with the $L command. Take this precaution whenever 
using $TRANS. It will insure that the receive end is ready for any data coming across the hne. 
Only after the receive end has been prepared, invoke $trans on the transmit end using the $L 
command. The session manager does not support this utiUty. Refer to the Operation Guide for 
step-by-step information on on use of the $TRANS utility. 

Load $TRANS on the receiving system. Respond to prompts as shown: 



r 



> SL $TRANS 
LOADING $TRANS 



$TRANS 



XXP, 12: 12:12, LP= 0000, PART= 2 
BISYNC TRANSPORT UTILITY 



THIS UTILITY SHOULD ONLY BE USED WHEN TRANSPORTING DATA 

SETS OR PROGRAMS OVER A BISYNC LINE. DO YOU WISH TO CONTINUE (Y/N)? Y 

IS THIS THE TRANSMITTING SYSTEM (Y/N)? N 

BSC RECEIVE PROGRAM ACTIVE 

ENTER BSC LINE ADDRESS IN HEX: 09 

BSC LINE OPEN - READY FOR TRANSMISSION 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 



Load $TRANS on the transmitting system. Respond to prompts as shown: 



> SL STRANS 
LOADING $TRANS 



$TRANS 



XXP,12:12:12, LP= 0000, PART= 2 
BISYNC TRANSPORT UTILITY 



THIS UTILITY SHOULD ONLY BE USED WHEN TRANSPORTING DATA 

SETS OR PROGRAMS OVER A BISYNC LINE. DO YOU WISH TO CONTINUE (Y/N)? Y 

IS THIS THE TRANSMITTING SYSTEM (Y/N)? Y 

BSC TRANSMIT PROGRAM ACTIVE 

ENTER BSC LINE ADDRESS IN HEX: 09 

ENTER SOURCE VOLUME: TEST! 

ENTER TARGET VOLUME: TEST2 

MEMBERS ON VOLUME TEST! WILL BE COPIED TO VOLUME TEST2 



Notes: 



1 . Messages regarding errors encountered on the receive end will appear on both the receive 
and transmit ends. 

2. If $TRANS is renamed to $initial, it will automatically be loaded at ipl time as a receive end 
with a default line address of 9. the receive program will automatically be loaded. 



M 

V 



$TRANS Commands 



To display the $TRANS commands at your terminal, enter a question mark in response to the 
prompting message COMMAND (?):. 



COMMAND (?): ? 

CALL - COPY ALL MEMBERS IN THE VOLUME 

CG - COPY GENERIC 

CM - COPY MEMBER 

CV - CHANGE VOLUME 

EN - END UTILITY 

ES - END UTILITY WITH SHUTDOWN ON RECEIVE END 



Each command follows in alphabetical order with an explanation. 



c 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 



CALL — Copy All Members in a Volume from Source to Target 

Use CALL to copy all members in a volume or all members starting from a certain member. 

Example: Copy all members. 

COMMAND (?): CALL 

COPY FROM THE BEGINNING (Y/N)? y 



ALL MEMBERS ON VOLUME 111 WILL BE COPIED TO VOLUME 

ARE ALL PARAMETERS CORRECT (Y/N)? y 



AAA 



(SLOADER and nucleus modules ($EDXNUCx) cannot be copied using 
the CALL command. Use the CM command to copy these modules.) 

$4978CS0 COPY COMPLETE 
$LOADER NOT COPIED 
DATA002 COPY COMPLETE 

COMMAND (?): 






Example: Copy all members starting from a certain member. 



COMMAND (?): CALL 

COPY FROM THE BEGINNING (Y/N)? N 
ENTER STARTING MEMBER NAME: EDXSVCX 

($LOADER and nucleus modules (SEDXNUCx) cannot be copied using 
the CALL command. Use the CM command to copy these modules.) 

ARE ALL PARAMETERS CORRECT (Y/N)? y 

EDXSVCX COPY COMPLETE 

#XMTSRC COPY COMPLETE 

STAPERT COPY COMPLETE 

DISKIO COPY COMPLETE 

RW001 COPY COMPLETE 

DATA003 COPY COMPLETE 

VOLUME TRANSMISSION COMPLETE 
COMMAND (?): 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 

CG — Copy All Members from Source to Target 

Use CG to copy all members from one system to another. 

Example: Copy All Members from Source to Target. 



COMMAND (?): CG 
ENTER GENERIC TEXT: A 

ASMWORK COPY COMPLETE 
ASMOBJ COPY COMPLETE 

COMMAND (?): CG 
ENTER GENERIC TEXT: B 

NO MATCH ON B 

COMMAND (?): 



CM 






Copy Member from Source to Target 

Use CM to copy a single member from one system to another. 

Example: Copy a member. 

COMMAND (?): CM 

ENTER THE DATA SET NAME: XXX 

(The following prompt appears only when $LOADER 

is specified as the data set you wish to copy. 

Respond "y" to the prompt issued and the copy will proceed, 

Respond "N" and the utility will return to command mode.) 



COPYING $LOADER TO AN I PL VOLUME MAY REQUIRE YOU TO RE- 1 PL THE SYSTEM. 
00 YOU WISH TO CONTINUE (Y/N)? Y 



XXX 



COPY COMPLETE 



V 



COMMAND (?) 



J 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 

CV — Change Source Volume 

Use CV to change source volume. 

Example: Change the source volume. 



COMMAND (?): cv 

ENTER SOURCE VOLUME: ZZZ 

ENTER TARGET VOLUME: AAA 

MEMBERS ON VOLUME ZZZ WILL BE COPIED TO VOLUME 



AAA 



COMMAND (?) 



EN — End $TRANS 



Use EN to end $trans at the transmit end. 



Example: End the $trans utility. 



COMMAND (?): EN 

BSC LINE CLOSED 

$TRANS ENDED AT 12:14:00 






ES — End $TRANS Utility with Shutdown on Receive End 

Use ES to end $trans at the transmit and receive ends. 

Example: End the $trans utiUty with shutdown on the transmit and receive ends. 



COMMAND (?): ES 

BSC LINE CLOSED 
REMOTE BSC LINE CLOSED 
$TRANS ENDED AT 12:14:00 



; 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 

Example 1 : The following example illustrates use of the cv (Change Volume,) CM (Copy 
Member) and CG (Copy Generic) commands. 



> $L $TRANS 
LOADING $TRANS 



$TRANS 



XXP,12:12:12, LP= 0000, PART= 2 
BISYNC TRANSPORT UTILITY 



THIS UTILITY SHOULD ONLY BE USED WHEN TRANSPORTING DATA SETS 

OR PROGRAMS OVER A BISYNC LINE. DO YOU WISH TO CONTINUE (Y/N)? Y 

IS THIS THE TRANSMITTING SYSTEM (Y/N)? Y 

BSC TRANSMIT PROGRAM ACTIVE 

ENTER BSC LINE ADDRESS IN HEX: 60 

ENTER SOURCE VOLUME: 111 

ENTER TARGET VOLUME: AAA 

MEMBERS ON VOLUME 111 WILL BE COPIED TO VOLUME AAA 

COMMAND (?): ? 

CALL - COPY ALL MEMBERS THE VOLUME 

CG - COPY GENERIC 

CM - COPY MEMBER 

CV - CHANGE VOLUME 

EN - END UTILITY 

ES - END UTILITY WITH SHUTDOWN ON RECEIVE END 

COMMAND (?): CM 

ENTER THE DATA SET NAME: XXX 



/f" 






XXX 



COPY COMPLETE 



v^ 



COMMAND (?): CG 
ENTER GENERIC TEXT: A 

ASMWORK COPY COMPLETE 
ASMOBJ COPY COMPLETE 

COMMAND (?): CG 
ENTER GENERIC TEXT: B 

NO MATCH ON B 

COMMAND (?): EN 

BSC LINE CLOSED 

$TRANS ENDED AT 12:lit:00 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 



Example 2: The following example illustrates use of the CALL (Copy All Members) command. 



"X, 



> $L $TRANS 
LOADING $TRANS 



$TRANS 



XXP,12:12:12, LP= 0000, PART= 2 
BISYNC TRANSPORT UTILITY 



THIS UTILITY SHOULD ONLY BE USED WHEN TRANSPORTING DATA SETS 

OR PROGRAMS OVER A BISYNC LINE. DO YOU WISH TO CONTINUE (Y/N)? Y 

IS THIS THE TRANSMITTING SYSTEM (Y/N)? Y 

BSC TRANSMIT PROGRAM ACTIVE 

ENTER BSC LINE ADDRESS IN HEX: 60 

ENTER SOURCE VOLUME: ZZZ 

ENTER TARGET VOLUME: AAA 

MEMBERS ON VOLUME ZZZ WILL BE COPIED TO VOLUME AAA 
COMMAND (?): CALL 



V 



COPY FROM THE BEGINNING (Y/N)? Y 

ALL MEMBERS ON VOLUME ZZZ WILL BE COPIED TO VOLUME 
ARE ALL PARAMETERS CORRECT (Y/N)? Y 

ASMOBJ COPY COMPLETE 
ASMWORK COPY COMPLETE 
BACKUP COPY COMPLETE 
LINKWORK COPY COMPLETE 

VOLUME TRANSMISSION COMPLETED 

COMMAND (?): EN 

BSC LINE CLOSED 

STRANS ENDED AT 12:14:00 



AAA 



,ji^ 
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$TRANS - Transmit Data Sets Across a Bisync Line (continued) 

Example 3: This example illustrates use of the call (Copy All Members) command that runs 
into overflow problems attempting to complete the copy. 



c 



> $L $TRANS 
LOADING $TRANS 



$TRANS 



XXP,12:12:12, LP= 0000, PART= 2 
BISYNC TRANSPORT UTILITY 



THIS UTILITY SHOULD ONLY BE USED WHEN TRANSPORTING DATA SETS 

OR PROGRAMS OVER A BISYNC LINE. DO YOU WISH TO CONTINUE (Y/N)? Y 

IS THIS THE TRANSMITTING SYSTEM? Y 

BSC TRANSMIT PROGRAM ACTIVE 

ENTER BSC LINE ADDRESS IN HEX: 60 

ENTER SOURCE VOLUME: ZZZ 

ENTER TARGET VOLUME: AAA 

MEMBERS ON VOLUME TEST WILL BE COPIED TO VOLUME TEST 

COMMAND (?): CALL 

COPY FROM THE BEGINNING (Y/N)? Y 

ALL MEMBERS ON VOLUME ZZZ WILL BE COPIED TO VOLUME AAA 

ARE ALL PARAMETERS CORRECT (Y/N)? Y 

ASMOBJ COPY COMPLETE 
ASMWORK COPY COMPLETE 
BACKUP COPY COMPLETE 
LINKWORK COPY COMPLETE 

DIRECTORY OR VOLUME OVERFLOW ON REMOTE SYSTEM 
CONTINUE ON ANOTHER VOLUME? Y 

ENTER CONTINUATION VOLUME NAME: BBB 

LINKWRK2 COPY COMPLETE 
LINKWRK3 COPY COMPLETE 

VOLUME TRANSMISSION COMPLETED 

COMMAND (?): EN 

BSC LINE CLOSED 

$TRANS ENDED AT 12:14:00 
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$TRAP - Save Storage on Error Condition 

The STRAP utility enables you to isolate intermittent hardware and software problemp When an 
error condition occurs, the utility writes, or "dumps," the contents of the hardware registers and 
processor storage to a disk or diskette data set. 

You can set Strap to dump processor storage when a specific type of error occurs, such as a 
program check. If the expected error or failure does not occur, you can force the utility to dump 
the contents of processor storage by entering the trapdump command or by pressing the 
console interrupt button on the programmer console. The use of the trapdump command and 
the console interrupt button are explained under "Forcing a $TRAP Dump" on page UT-593. 

Once an error has occurred^nd Strap has captured the contents of processor storage, you must 
IPL the system in order to continue processing. 

The SDUMP utility formats and prints the data saved by Strap. 
Considerations When Using $TRAP 

Consider the following when you use STRAP: 

• You must load STRAP in partition 1 . 

• STRAP must be active when an error occurs. For this reason, you should use STRAP when a 
problem exists and you are confident that you can reproduce the problem. For example, all 
programs that were active when the problem occurred should be active and in the same 
partitions. In addition, all devices that were switched on at the time the problem occurred 
should also be switched on when you start STRAP. 

• STRAP dumps all of physical storage residing on your system. For this reason, make sure 
your dump data set is large enough to hold all mapped and unmapped storage. 

If you cannot use STRAP, you should perform a stand-alone dump of processor storage and send 
the diskette(s) with an apar to IBM. The Operation Guide explains the procedure for taking a 
stand-alone dump. If you are preparing an apar and you wish to send IBM a copy of your STRAP 
or stand alone dump data set, you may need to send two or more diskettes. If your Strap data 
set was dumped to disk, you will need to follow the procedure in the Operation Guide on 
"Copying a $TRAP Data Set to Two Diskettes." 
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$TRAP - Save Storage on Error Condition (continued) 



Allocating a Data Set 



STRAP dumps the mapped and umnapped storage areas of the system to a work data set which 
you supply. You have three options available for creating the data set: 

1 . Disk — You must create the disk data set at least as large as your system's physical storage. 

2. One Diskette — You must create the diskette data set at least as large as your system's 
physical storage. You can use one diskette if your storage is not greater than 512K, 

3. Two Diskettes — If your storage is greater than 512K, you must create two identical 
diskettes by using primary option of the $dasdi utility. The name and volume must be the 
same for both diskettes ($$EDXLIB,IBMEDX). 

Note: You may want to number the diskettes "1" and "2" so you can distinguish them 
more easily later on. 

When dumping to diskettes created by using primary option of the $dasdi utility, it is not 
necessary to allocate the STRAP work data set. However, if you are not dumping to these 
diskettes, you must calculate the data set size needed and allocate the data set using the 
SDISKUTI utility. 






Loading $TRAP 



To determine the size of the work data set, multiply the amount of physical storage in your 
system by four. For example, if you have 512K bytes of physical storage, you must allocate a 
data set of at least 2048 records. With 1024K bytes of physical storage, the Strap work data 
set must be a minimum size of 4096 records. 



You must load STRAP in partition 1. To load the utility, press the attention key and type $L 
STRAP. As shown in the following example, the system requests the name of the Strap work 
data set and volume. 



V 



> SL $TRAP 

DUMP (NAME, VOLUME): TRAPWORK.MYVOL 
LOADING $TRAP 22P, LP= BAOO, PART=1 



v... 



Note: 

If your dump data set resides on diskette and you are using a 4966, the diskette must be in slot 
one (1). 



C) 
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$TRAP - Save Storage on Error Condition (continued) 



Selecting The Conditions for the Dump 



After you load Strap and enter the name of the work data set, the utility displays the strap 
commands. Before entering a command, such as trapon, you must specify under what 
conditions you want the Strap dump to be taken. The utility displays the conditions, one at a 
time, and asks if it should dump processor storage on each condition. You can respond Y (YES) 
to one or all of the conditions shown here: 

Machine Check: Indicates that your system has a hardware problem. If you respond Y to this 
prompt, the utility saves the hardware registers and storage when a storage parity, CPU control, 
or I/O check occurs. For an explanation of these errors, refer to the description manual for 
your processor. 

Program Check: Indicates an error in an appUcation program. If you respond Y to this 
prompt, the utility prompts you for the type of program check to trap. You can select any 
combination of the following five types: 

• Specification Check — Occurs if a storage address violates boundary requirements. For 
example, a specification check occurs if a program attempts to move a word of data to an 
odd-byte boundary. 

• Invalid Storage Address — Occurs when a program attempts to refer to a storage address 
outside of the storage size of the partition. This error occurs, for example, if a program 

f^ attempts to do a cross-partition move to a nonexistent partition, 

• Privilege Violate — Occurs if a program in problem state attempts to issue a privileged 
instruction. A privileged instruction can execute only if the program is in supervisor state. 

Normally, this error never occurs in an EDL program. 

• Protect Check — Occurs if a program attempts to use protected storage. The processor can 
control access to areas in storage by using a storage protect feature. 

Normally, this error would never occur in an EDL program. 

• Invalid Function (Program Check) — Occurs if the system attempts to execute an illegal 
operation code. 
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$TRAP - Save Storage on Error Condition (continued) 



Soft Exception: Indicates a software error that the system software is equipped to handle. If 
you respond Y to this prompt, the system prompts you for the type of soft exception to trap. 
You can select any combination of the following three types: 

• Invalid Function (Soft Exception) — Occurs if a program attempts to execute an instruction 
associated with a feature that is not contained in the supervisor. This error can occur, for 
example, if an edl program attempts to use floating-point instructions (fadd, fsub, fmult, 
or fdivd) when the supervisor does not support floating-point. 

• Floating-Point Exception — Occurs when the optional floating-point processor detects an 
error condition. An edl program can detect such an error condition by testing the return 
code from a floating-point instruction. 

Respond N to this prompt if your system does not have floating-point hardware. 

• Stack Exception — Occurs when a program attempts to move an operand from an empty 
processor storage stack into a register or to move an operand from a register into a full 
processor storage stack. A stack exception also occurs when the stack cannot contain the 
number of words to be stored by an assembler Store Multiple (stm) instruction. 

Normally, this error never occurs in an edl program. 

Console Interrupt: Respond y to this prompt if you want to be able to use the console 
interrupt button on the programmer console to force a $trap dump. 



\.. 



Save Floating-Point Registers: Respond y to this prompt to save the contents of the ^- ^ 

floating-point registers when an error condition occurs. Respond N to this prompt if your 
system does not have floating-point hardware. 



\J 
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$TRAP - Save Storage on Error Condition (continued) 

Starting, Suspending, and Ending $TRAP 

Once you've selected the error conditions to trap, the utility displays the following messages: 

$TRAP IS NOW SUSPENDED. PRESS THE ATTENTION KEY (>) AND 
ENTER ONE OF THE FOLLOWING COMMANDS: 
-TO START $TRAP: TRAPON 

-TO FORCE A DUMP; TRAPDUMP 
-TO SUSPEND $TRAP: TRAPOFF 
-TO END $TRAP: TRAPEND 

— ■ ■■ ■ [ ■ ^ 

You can "start" $trap now by pressing the attention key and entering TRAPON. The system 
returns the message: "$TRAP STARTED." 

The TRAPON command activates the trap utility but does not produce a storage dump. After 
starting STRAP in partition 1, you should reload all programs and start all devices that were 
running when the error occurred. Remember to load the programs into the same partitions that 
they were in when you noticed the problem. 

If STRAP encounters the error you specify, it dumps the hardware registers and the contents of 
processor storage to the data set you specified when you loaded STRAP. The dump is complete 
when your console lights display 'FFFF' Refer to "Dumping to Multiple Diskettes" on page 
UT-597 for an explanation of how to dump to two diskettes. You must then ipl the system to 
continue processing. Note the load points of the programs so you can display program storage if 
necessary with SDUMP. Use SDUMP to retrieve, format, and print the contents of the strap work 
data set. 

If you have a programmer console and you run your Series/ 1 in Diagnostic mode, you will 
receive a stop code of E9 if the STRAP dump is successful. 

Note: 

If you set STRAP to trap a program check, the program check message will not appear when you 
take the strap dump. In addition, if a program has a task error exit routine, that routine will not 
receive control. 

To suspend the STRAP utility at any point, change to partition 1, press the attention key and 
enter trapoff. The system returns the message: "Strap suspended (trapon restarts 
STRAP)." This command stops Strap until you start the utility again with the trapon command. 

To end or cancel the STRAP utility, press the attention key and enter the trapend command in 
partition 1. The system returns the message: "Strap terminated." Do not use the SC operator 
command to cancel Strap. 

Forcing a $TRAP Dump 

If an error condition (detectable by STRAP) does not occur while Strap is active, you can still 
force a dump of storage by pressing the attention key and entering trapdump in partition 1 . If 
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$TRAP - Save Storage on Error Condition (continued) 

you have a programmer console, you can force a dump by pressing the console interrupt button. 
(To use this option, you must have replied Y to the prompt "DUMP ON CONSOLE interrupt? 

(Y/N).") 



c 



J 



Example 1 



The following example shows the various options of the STRAP utility. A description of each of 
the numbered items follows the example. 



> $L $TRAP 
DUMP (NAME, VOLUME): TRAPWRK.CLOOl 
LOADING $TRAP 22P, LP= BAOO, PART=1 



TO END $TRAP BEFORE A DUMP IS TAKEN, PRESS THE ATTENTION KEY (>) 
AND ENTER: TRAPEND 

— DO NOT USE $C TO END THIS UTILITY — 



SELECT ONE OR MORE OF THE FOLLOWING CONDITIONS; 

DUMP ON MACHINE CHECK (Y/N)? y 

DUMP ON PROGRAM CHECK (Y/N)? y 

SPECIFICATION CHECK (Y/N)? y 
INVALID STORAGE ADDRESS (Y/N)? y 
PRIVILEGE VIOLATE (Y/N)? y 
PROTECT CHECK (Y/N)? y 
INVALID FUNCTION (Y/N)? y 

DUMP ON SOFT EXCEPTION (Y/N)? y 

INVALID FUNCTION (Y/N)? y 
FLOATING-POINT EXCEPTION (Y/N)? y 
STACK EXCEPTION (Y/N)? y 

DUMP ON CONSOLE INTERRUPT (Y/N)? y 
SAVE FLOATING-POINT REGISTERS (Y/N)? y 






$TRAP IS NOW SUSPENDED. PRESS THE ATTENTION KEY (>) AND 
ENTER ONE OF THE FOLLOWING COMMANDS: 



-TO START $TRAP: 
-TO FORCE A DUMP: 
-TO SUSPEND $TRAP; 
-TO END $TRAP: 



TRAPON 
TRAPDUMP 
TRAPOFF 
TRAPEND 



NOTE: IF A DUMP OCCURS, YOU MUST I PL THE SYSTEM 



> TRAPON 
$TRAP STARTED 
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$TRAP - Save Storage on Error Condition (continued) 

H Load STRAP. 

Q Enter the data set name and volume of the Strap work data set. 

Q Set STRAP to dump storage when it encounters a machine check, program check, or soft 
exception. 

Q Indicate that you want the option of using the console interrupt button to force a Strap 
dump. 

Q Indicate that you want to save the floating-point registers (if you have floating-point 
hardware installed). 

Q The utility initially sets itself to "off." 

Q Start STRAP. Duplicate the problem you wish to trap. 

In the following example, Strap is set to dump the hardware registers and the contents of 
processor storage when a specification check occurs. When the specification check does not 
occur, the operator suspends the utility and then ends it. A description of each of the numbered 
items follows the example. 



Cx, 
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$TRAP - Save Storage on Error Condition (continued) 



Example 2 



H 



> $L $TRAP 
DUMP (NAME, VOLUME): TRAP I T,EDX003 
LOADING $TRAP 22P, LP= BAOO, PART=1 






TO END $TRAP BEFORE A DUMP IS TAKEN, PRESS THE ATTENTION KEY (>) 
AND ENTER: TRAPEND 

-- DO NOT USE $C TO END THIS UTILITY — 



SELECT ONE OR MORE OF THE FOLLOWING CONDITIONS; 

DUMP ON MACHINE CHECK (Y/N)? N 
DUMP ON PROGRAM CHECK (Y/N)? Y 

SPECIFICATION CHECK (Y/N)? Y 

INVALID STORAGE ADDRESS (Y/N)? N 

PRIVILEGE VIOLATE (Y/N)? N 

PROTECT CHECK (Y/N)? N 

INVALID FUNCTION (Y/N)? N 
DUMP ON SOFT EXCEPTION (Y/N)? N 
DUMP ON CONSOLE INTERRUPT (Y/N)? 



N 



SAVE FLOATING-POINT REGISTERS (Y/N)? N 



$TRAP IS NOW SUSPENDED. PRESS THE ATTENTION KEY (>) AND 
ENTER ONE OF THE FOLLOWING COMMANDS: 
-TO START STRAP: TRAPON 
-TO FORCE A DUMP: TRAPDUMP 
-TO SUSPEND STRAP: TRAPOFF 
-TO END $TRAP: TRAPEND 






NOTE: IF A DUMP OCCURS, YOU MUST I PL THE SYSTEM 



> TRAPON 
$TRAP STARTED 

> TRAPOFF 

$TRAP SUSPENDED (TRAPON RESTARTS $TRAP) 

> TRAPEND 
$TRAP TERMINATED 
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$TRAP - Save Storage on Error Condition (continued) 

Q Load STRAP. 

Q Enter the data set name and volume of the Strap work data set. 

Q Set STRAP to dump storage when it encounters a specification check. 

Q Start STRAP. 

Q Suspend Strap. If the error occurs before the operator enters this command, the 
operator must ipl the system. 

01 End STRAP. The SDUMP utility formats and prints the data saved by Strap, 
Dumping to Multiple Diskettes 

To dump to multiple diskettes, mount the first SDASDI, primary-option-0-formatted diskette, load 
STRAP, and reply to the prompts as in example 2 with the exception of dump (name, volume). 
The NAME,VOLUME wiU be SSEdxlib,ibmedx. Then when a specification check occurs, strap 
starts dumping to $$edxlib,ibmedx. The programmer console Ughts indicate one of the 
following: 

FFF2 Insert the next diskette in the same slot where you mounted the first one. The 

dump completes automatically. 

FFFF The dump is complete; IPL the system. 

1111 Invalid format on the diskette. There is a possibility that you have used the wrong 

diskette. 

Use the SDUMP utility to format and print the data saved by Strap. 



# 
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$UPDATE - Converting Series/1 Programs 



The $UPDATE conversion utility converts an object module into an executable, relocatable load 
module. 

The object module used as input to $UPDATE may have been compiled by the Event Driven 
Language compiler $EDXASM or the host assembler. Object modules created by the host 
assembler must be transmitted to a Series/ 1 disk or diskette volume by a facility such as the IBM 
2780/3780 RJE emulation utility $RJE2780/$RJE3780, or by the $hcfuti utility, before you can 
use them as the input to SUPDATE. 

The object output of language translators other than $edxasm or the host assembler must be 
processed by the linkage editor, $edxlink 



Required Data Sets 



$UPDATE requires the following data sets. You must specify these data sets when you invoke 

$UPDATE. 

1. The object-input data set is the output of $EDXASM and serves as input to $update. 

2. The program-output data set is the data set where the output of $update is to be placed. 
$UPDATE allocates this data set if it does not exist. 



Invoking $UPDATE 



You invoke $update with the $L operator command, option 2.9 of the session manager, or with 
the batch job stream processor ($jobutil). 






Updating a Program Using the $L Operator Command 

When you invoke $UPDATE with the $L operator command, it prompts you for the information it 
requires. Examples of this interactive usage follow. 

Invoking $UPDATE Using the $L Operator Command 

This example shows $update being loaded for execution and the subsequent prompt messages. 



> $L $UPDATE 
LOADING $UPDATE 



35P, 00: 17:51, LP= itSOO, PART=1 



THE DEFINED INPUT VOLUME IS EDX002, OK? Y 
THE DEFINED OUTPUT VOLUME IS EDX002, OK? Y 

COMMAND (?): 
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$UPDATE - Converting Series/1 Programs (continued) 

$UPDATE Commands 

To display the Supdate commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 



COMMAND (?): ? 

CV - CHANGE VOLUME 
RP - READ PROGRAM 
EN - END 

COMMAND {?): 



Each command and its explanation is presented in alphabetical order on the following pages. 
CV — Change Volume 

Use the CV command to change the input or output volume. For example: 

COMMAND (?): CV 

THE DEFINED INPUT VOLUME IS EDX002, OK? N 

ENTER NEW INPUT VOLUME LABEL: EDXOO3 

THE DEFINED OUTPUT VOLUME IS EDX003, OK? Y 

COMMAND (?): 
If the volume is not mounted: 



V 



COMMAND (?): CV 

THE DEFINED INPUT VOLUME IS EDX003, OK? N 
ENTER NEW INPUT VOLUME LABEL: EDXDFG 
VOLUME OFF LINE 

THE DEFINED INPUT VOLUME IS EDX003, OK? 



J 
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$UPDATE - Converting Series/1 Programs (continued) 

EN — End $UPDATE 

Use the EN command to end $update processing. 
Example: 



/ffN, 



V 



COMMAND (?): EN 

SUPDATE ENDED AT 11:39:3^ 



RP — Read and Store a Program 



Use the rp command to read (convert) and store a program in an allocated data set. If the data 
set targeted for receiving output from the conversion process is not allocated, $update allocates 
the data set. 

Example 1 : Convert and store a new program. This example allocates a new data set 
TESTPROG (type PGM) of the required size if a data set with that name has not already been 
allocated. 



CO 


M 


-lAND (?): RP 




OB 


J 


ECT MODULE NAME 


: OBJSET 


OU 


TPUT PGM NAME: 


TESTPROG 


TE 


STPROG STORED 




CO 


M 


'lAND (?): 





i_.,^^ 



J 



If you specify the name of an input object module that does not exist, $update takes no action. 
For example: 



COMMAND (?): RP 

OBJECT MODULE NAME: DUMMY 

OUTPUT PGM NAME: PROGRAM 

INPUT DATA SET 'DUMMY' NOT FOUND 
COMMAND (?): 



In addition, an appropriate error message is issued if the output data set was not defined as a 
program type. 



J 
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$UPDATE - Converting Series/1 Programs (continued) 



•%.^ 



Example 2: Convert and store a program where program and object module names are to be 
the same. In this example, an asterisk (*) is entered in place of the output data set name if the 
name is to be the same as the input data set name. 



COMMAND (?) 



RP 



OBJECT MODULE NAME: 



OUTPUT PGM NAME 



OBJSET 



PROGRAM NAME DEFAULTED TO OBJSET 
OBJSET STORED ON EDX003 
COMMAND (?): 



V. 



Example 3: Convert and replace existing output program with same output name. In this 
example, an existing output program is replaced with a new output program. If the new and old 
sizes are the same, the new program data replaces the old with no other changes. If the new 
space required is different from the existing space, the existing data set is deleted and a new one 
of the proper size is allocated wherever enough free space is available. 



COMMAND 


(?): RP 
MODULE NAM 
=GM NAME: 

REPLACE? 

STORED ON 

(?): 


^" OBJSET 










OBJECT 








OUTPUT 












TSTPRG1 










TSTPRG1 


Y 
EDX002 










TSTPRG1 














COMMAND 











Example 4: Convert and rename new output program if an output program aheady exists. 
The existing output data set is undisturbed and a new data set (type PGM) of the proper size and 
with the new name is allocated. 



COMMAND (?): p^p 
OBJECT MODULE NAME; 



OBJSET 



OUTPUT PGM NAME: tfctprog 
TESTPROG REPLACE? 
RENAME? w 



N 



NEW PGM NAME: ^STPRGl 
TSTPRGl STORED ON EDX003 
COMMAND (?): 
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$UPDATE - Converting Series/1 Programs (continued) 

Updating a Program Using the Session Manager 

To invoke $update using the session manager, select option 2.9. 

Figure 39 shows the parameter input menu for entry of the required data sets and other 
parameters. The object program in data set ASMOBJ is to be formatted and placed in data set 
TSTPGM. The REPLACE parameter is left blank when a member does not aheady exist. If the 
member does exist, enter YES. 



$SMM0209: SESSION MANAGER $UPDATE PARAMETER INPUT MENU 
ENTER/SELECT PARAMETERS PRESS PF3 TO RETURN 

OBJECT INPUT (NAME, VOLUME) ==========> aSMOBJ ,EDX002 

PROGRAM OUTPUT (NAME .VOLUME) ==========> TSTPGM, EDX003 

REPLACE (ENTER YES IF PROGRAM EXISTS) ===> 

LISTING (TERMINAL NAME/*) =========> $SYSPRTR 

NOTE: THE OBJECT INPUT, PROGRAM OUTPUT, AND LISTING TERMINAL 
NAME ARE REQUIRED PARAMETERS AND MUST BE ENTERED. 
AN '*' MAY BE USED TO SPECIFY THIS TERMINAL AS 
THE LISTING TERMINAL 



A 



Figure 39. $UPDAT£ parameter input menu 



Updating a Program Using $JOBUTIL 



When you use the job-stream processor ($JOBUTlL) to invoke $UPDATE, the information that 
$UPDATE requires must be passed by the PARM command of $JOBUTlL. The required information 
consists of: 

1 . The name of the device to receive the printed output resulting from $UPDATE execution. 

2. The name,volume of the data set containing the input object module. The volume name, if 
omitted, defaults to the IPL volume. 






3. The name, volume of the data set to contain the output loadable program. The volume name, 
if omitted, defaults to the ipl volume. 

4. The optional parameter YES if the output module is to replace an existing module of the 
same name,volume. 

The first three items of information are required and must be given in the order described. At 
least one blank must occur between each of these four items in the parm command. 

When you invoke $UPDATE under $jobutil, the system assumes you mean the "read program" 
(rp) command. The "rename" function is not supported, but the "replace" function is. Refer 
to the preceding examples for a description of rename and replace. 
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$UPDATE - Converting Series/1 Programs (continued) 



In batch mode, $update terminates after performing one RP command. A completion code is 
set by $UPDATE depending upon the success or failure of the requested operation. You can test 
this code by the jump command of $J0BUTIL. 

Note: The $UPDATE completion codes are described in the Messages and Codes book. 

The following is an example of invoking $update via $jobutil commands. 



PROGRAM 


$UPDATE 








FARM 


$SYSPRTR 


0BJM0D,V0L1 


MYPROG 


YES 


NOMSG 










EXEC 














In this example, $sysprtr receives the printed messages, the input object module is objmod on 
VOLI, and the output program is myprog on the ipl volume. If myprog already exists on the 
IPL volume, it is replaced by the new version. If MYPROG does not already exist, SUPDATe: 
allocates space for it. 



$UPDATE Output 



The output load module is stored in the output data set upon successful completion of the rp 
command of $update. 



Considerations When Creating a Supervisor 



You can create multiple supervisor programs for different machine configurations on one 
Series/ 1. You can then copy them to diskettes which can be used on the Series/ 1 having the 
proper configuration. 
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$UPDATE - Converting Series/1 Programs (continued) 



The name $EDXNUC for the output program receives special treatment by $update since the 
creation of a supervisor results in an absolute rather than a relocatable program. The following 
rules apply: 

1. If the first seven characters of the output program name are $edxnuc, then an absolute 
supervisor program is formatted. 

2. The eighth character can be a blank or any other character. The output program replaces an 
existing program or creates a new program by that name on the specified volume. 

3. An existing supervisor program is not deleted and reallocated by the update program. The 
new version must fit in the existing space. 

To test supervisors created and stored by $UPDATE, either: 

• Copy the new supervisor nucleus into the ipl supervisor on the ipl volume and ipl the 
system again, or 

• Rewrite the ipl text on the volume on which the supervisor is located using the $initdsk 
utility option ii. 



\.^ 
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$UPDATEH 

$UPDATEH - Converting Host System Programs 

$UPDATEH transfers, over a communications link, Series/ 1 object programs that are members of 
a host-partitioned data set (pds) and stores them in a Series/ 1 disk or diskette volume in the 
proper format to be loaded for execution. The programs must have been assembled previously 
on the host. 

To change the name of the default host library, locate the label "hostname" in the $updateh 
listing and change the name to the host library name you want. Then you must assemble 
$UPDATEH and install it in the program library. 

$UPDATEH requires that the Event Driven Executive Host Communication Facility (lup 
5796-pgh) be installed on the host computer. 

Invoking $UPDATEH 

You invoke $updateh with the $L operator command, option 2.10 of the session manager, or 
with the batch job-stream processor ($JOBUTlL). 

Updating a Hosting Program Using the $L Operator Command 

When you invoke $UPDATEH with the $L operator command, it prompts you for the information 
it requires. Examples of this interactive usage follow. 

This example shows $updateh being loaded with the $L operator command and the subsequent 
messages that follow. 

> $L 

PGM(NAME, VOLUME): SUPDATEH 

LOADING SUPDATEH 28P , 1 5 : 29: 59, LP=^400, PART=2 

THE DEFINED HOST LIBRARY IS S 1 .EDX. LOADL I B OK (Y/N)? Y 
THE DEFINED VOLUME IS EDX002,0K (Y/N)? Y 

COMMAND (?): 



SUPDATEH Commands 

To display the SUPDATEH commands at your terminal, enter a question mark in response to the 
prompting message command (?):. 

COMMAND (?): ? 

CH CHANGE HOST LIBRARY 

CV CHANGE VOLUME 

RP READ PROGRAM 

EN END 

COMMAND (?): 
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$UPDATEH - Converting Host System Programs (continued) 

After $UPDATEH displays the commands, it prompts you with COMMAND (?): again. Then you 
can respond with the command of your choice (for example, CH). Each command and its 
explanation is presented in alphabetical order on the following pages. 

CH — Change Host Library 

Use the CH command to change the host library. The system prompts you for the new host 
library name. 

Example: Change the host library. 



COMMAND (?): CH 

ENTER HOST LIBRARY NAME: S 1 .EDX.LOADL I B2 

COMMAND (?): 



y 



CV — Change Volume 

Use the CV command to change the volume. The system prompts you for the new volume label. 

Example: Change the volume. 



COMMAND (?): CV 

ENTER VOLUME LABEL: E0X003 

COMMAND (?): 






EN 



End $UPDATEH 

Use the en command to end the $updateh utility. 

Example: End $updateh. 

COMMAND (?): EN 
$UPDATEH ENDED 15.30.5^ 
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$UPDATEH - Converting Host System Programs (continued) 



RP — Read a Program 



Use the RP command to transfer a new program to a Series/ 1 data set, transfer a program and 
rename it, or transfer and replace an existing program. 

Example 1 : Transfer a new program to a Series/ 1 data set. 

COMMAND (?): RP 

PROGRAM NAME: TPTEST 
PROGRAM: TPTEST STORED 

COMMAND(?): 



C 



Example 2: Transfer and replace an existing program. 



COMMAND 


(?): 

NAME: 
PLACE 
PROGl 


RP 








PROGRAM 


PROGl 






PROGl RE 


(Y/N)? Y 
STORED 






PROGRAM: 








COMMAND ( 


?): 









Example 3: Transfer a program progi and rename it PROG2. The existing program (PROGl) 
is not replaced. 

COMMAND {?): RP 

PROGRAM NAME: PROGl 

PROGRAM: PROGl REPLACE (Y/N)? N 

RENAME (Y/N)? Y 

PROGRAM NAME: PR0G2 
PROGRAM: PR0G2 STORED 



V 



COMMAND(?) 



y 



Updating a Host Program Using $JOBUTIL or Session Manager 

When you load $updateh with the job-stream processor $jobutil or the session manager, it 
prompts you for control information. Execution is controlled as described above. 
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Glossary of Terms and Abbreviations 






This glossary defines terms and abbreviations used in the Series/ 1 Event Driven Executive software publications. All software and 
hardware terms pertain to EDX. This glossary also serves as a supplement to the /BM Data Processing Glossary, GC20- 1 699. 



$SYSLOGA. $SYSLOGB. The name of the alternate system 
logging device. This device is optional but, if defined, should be 
a terminal with keyboard capability, not just a printer. 

$SYSLOG. The name of the system logging device or operator 
station; must be defined for every system. It should be a terminal 
with keyboard capability, not just a printer. 

$SYSPRTR. The name of the system printer. 

abend. Abnormal end-of-task. Termination of a task prior to its 
completion because of an error condition that cannot be resolved 
by recovery facilities while the task is executing. 

ACCA. See asynchronous communications control adapter. 

address key. Identifies a set of Series/ 1 segmentation registers 
and represents an address space. It is one less than the partition 
number. 

address space. The logical storage identified by an address key. 
An address space is the storage for a partition. 

application program manager. The component of the Multiple 
Terminal Manager that provides the program management 
facilities required to process user requests. It controls the 
contents of a program area and the execution of programs within 
the area. 

application program stub. A collection of subroutines that are 
appended to a program by the linkage editor to provide the link 
from the application program to the Multiple Terminal Manager 
facilities. 



asynchronous communications control adapter. An ASCII 
terminal attached via #1610, #2091 with #2092, or #2095 with 
#2096 adapters. 

attention key. The key on the display terminal keyboard that, if 
pressed, tells the operating system that you are entering a 
command. 

attention list. A series of pairs of 1 to 8 byte EBCDIC strings 
and addresses pointing to EDL instructions. When the attention 
key is pressed on the terminal, the operator can enter one of the 
strings to cause the associated EDL instructions to be executed. 

backup. A copy of data to be used in the event the original data 
is lost or damaged. 

base record slots. Space in an indexed file that is reserved for 
based records to be placed. 

base records. Records are placed into an indexed file while in 
load mode or inserted in process mode with a new high key. 

basic exchange format. A standard format for exchanging data 
on diskettes between systems or devices. 

binary synchronous device data block (BSCDDB). A control 
block that provides the information to control one Series/ 1 
Binary Synchronous Adapter. It determines the line 
characteristics and provides dedicated storage for that line. 
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block. (1) See data block or index block. (2) In the Indexed 
Method, the unit of space used by the access method to contain 
indexes and data. 

block mode. The transmission mode in which the 3101 Display 
Station transmits a data data stream, which has been edited and 
stored, when the SEND key is pressed. 



BSCAM. 

method. 



See binary synchronous communications access 



binary synchronous communications access method. A form 
of binary synchronous I/O control used by the Series/ 1 to 
perform data communications between local or remote stations. 

BSCDDB. See binary synchronous device data block. 

buffer. An area of storage that is temporarily reserved for use in 
performing an input/output operation, into which data is read or 
from which data is written. See input buffer and output buffer. 

bypass label processing. Access of a tape without any label 
processing support. 

CCB. See terminal control block. 

central buffer. The buffer used by the Indexed Access Method 
for all transfers of information between main storage and indexed 
files. 

character image. An alphabetic, numeric, or special character 
defined for an IBM 4978 Display Station. Each character image 
is defined by a dot matrix that is coded into eight bytes. 

character image table. An area containing the 256 character 
images that can be defined for an IBM 4978 Display Station. 
Each character image is coded into eight bytes, the entire table of 
codes requiring 2048 bytes of storage. 

character mode. The transmission mode in which the 3101 
Display Station immediately sends a character when a keyboard 
key is pressed. 

cluster. In an indexed file, a group of data blocks that is pointed 
to from the same primary-level index block, and includes the 
primary-level index block. The data records and blocks 
contained in a cluster are logically contiguous, but are not 
necessarily physically contiguous. 

COD (change of direction). A character used with ACCA 
terminal to indicate a reverse in the direction of data movement. 

cold start. Starting the spool facility by erasing any spooled jobs 
remaining in the spool data set from any previous spool session. 



command. A character string from a source external to the 
system that represents a request for action by the system. 

common area. A user-defined data area that is mapped into the 
partitions specified on the SYSTEM definition statement. It can 



be used to contain control blocks or data that will be accessed by 
more than one program. 

completion code. An indicator that reflects the status of the 
execution of a program. The completion code is displayed or 
printed on the program's output device. 

constant. A value or address that remains unchanged thoughout 
program execution. 

controller. A device that has the capability of configuring the 
GPIB bus by designating which devices are active, which devices 
are listeners, and which device is the talker. In Series/ 1 GPIB 
implementation, the Series/1 is always the controller. 

conversion. See update. 

control station. In BSCAM communications, the station that 
supervises a multipoint connection, and performs polling and 
selection of its tributary stations. The status of control station is 
assigned to a BSC line during system generation. 

cross-partition service. A function that accesses data in two 
partitions. 

cross-partition supervisor. A supervisor in which one or more 
supervisor modules reside outside of partition 1 (address space 
0). 

data block. In an indexed file, an area that contains control 
information and data records. These blocks are a multiple of 256 
bytes. 



data record. 

data. 



In an indexed file, the records containing customer 



data set. A group of records within a volume pointed to by a 
directory member entry in the directory for the volume. 

data set control block (DSCB). A control block that provides 
the information required to access a data set, volume or directory 
using READ and WRITE. 

data set shut down. An indexed data set that has been marked 
(in main storage only) as unusable due to an error. 

DCE. See directory control entry. 

device data block (DDB). A control block that describes a disk 
or diskette volume. 

direct access. (1) The access method used to READ or WRITE 
records on a disk or diskette device by specifying their location 
relative the beginning of the data set or volume. (2) In the 
Indexed Access Method, locating any record via its key without 
respect to the previous operation. (3) A condition in terminal I/O 
where a READTEXT or a PRINTEXT is directed to a buffer which 
was previously enqueued upon by an lOCB. 
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directory. (1) A series of contiguous records in a volume that 
describe the contents in terms of allocated data sets and free 
space. (2) A series of contiguous records on a device that 
describe the contents in terms of allocated volumes and free 
space. (3) For the Indexed Access Method Version 2, a data set 
that defines the relationship between primary and secondary 
indexed files (secondary index support). 

directory control entry (DCE). The first 32 bytes of the first 
record of a directory in which a description of the directory is 
stored. 

directory member entry (DME). A 32-byte directory entry 
describing an allocated data set or volume. 

display station. An IBM 4978, 4979, or 3101 display terminal or 
similar terminal with a keyboard and a video display. 

DIVIE. See directory member entry. 

DSCB. See data set control block. 

dynamic storage. An increment of storage that is appended to a 
program when it is loaded. 

end-of-data indicator. A code that signals that the last record of 
a data set has been read or written. End-of-data is determined 
by an end-of-data pointer in the DME or by the physical end of 
the data set. 

ECB. See event control block. 

EDL. See Event Driven Language. 

emulator. The portion of the Event Driven Executive supervisor 
that interprets EDL instructions and performs the function 
specified by each EDL statement. 

end-of-tape (EOT). A reflective marker placed near the end of a 
tape and sensed during output. The marker signals that the tape 
is nearly full. 

enter key. The key on the display terminal keyboard that, if 
pressed, tells the operating system to read the information you 
entered. 

event control block (ECB). A control block used to record the 
status (occurred or not occurred) of an event; often used to 
synchronize the execution of tasks. ECBs are used in conjunction 
with the WAIT and POST instructions. 

Event Driven Language (EDL). The language for input to the 
Event Driven Executive compiler ($EDXASM), or the Macro and 
Host assemblers in conjunction with the Event Driven Executive 
macro libraries. The output is interpreted by the Event Driven 
Executive emulator. 

EXIO (execute input or output). An EDL facility that provides 
user controlled access to Series/1 input/output devices. 



external label. A label attached to the outside of a tape that 
identifies the tape visually. It usually contains items of 
identification such as file name and number, creation data, 
number of volumes, department number, and so on. 

external name (EXTRN). The 1- to 8-character symbolic 
EBCDIC name for an entry point or data field that is not defined 
within the module that references the name. 

FCA. See file control area. 

FCB. See file control block. 

file. A set of related records treated as a logical unit. Although 
file is often used interchangeably with data set, it usually refers to 
an indexed or a sequential data set. 

file control area (FCA). A Multiple Terminal Manager data area 
that describes a file access request. 

file control block (FCB). The first block of an indexed file. It 
contains descriptive information about the data contained in the 
file. 

file control block extension. The second block of an indexed 
file. It contains the file definition parameters used to define the 
file. 

file manager. A collection of subroutines contained within the 
program manager of the Multiple Terminal Manager that provides 
common support for all disk data transfer operations as needed 
for transaction-oriented application programs. It supports 
indexed and direct files under the control of a single callable 
function. 

floating point. A positive or negative number that can have a 
decimal point. 

formatted screen image. A collection of display elements or 
display groups (such as operator prompts and field input names 
and areas) that are presented together at one time on a display 
device. 

free pool. In an indexed data set, a group of blocks that can be 
used for either data blocks or index blocks. These differ from 
other free blocks in that these are not initially assigned to specific 
logical positions in the file. 

free space. In an indexed file, records blocks that do not 
currently contain data, and are available for use. 

free space entry (FSE). An 8-byte directory entry defining an 
area of free space within a volume or a device. 

FSE. See free space entry. 

general purpose interface bus. The IEEE Standard 488-1975 
that allows various interconnected devices to be attached to the 
GPIB adapter (RPQ D021 18). 
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GPIB. See general purpose interface bus. 

group. A unit of 100 records in the spool data set allocated to a 
spool job. 

H exchange format. A standard format for exchanging data on 
diskettes between systems or devices. 

host assembler. The assembler licensed program that executes 
in a 370 (host) system and produces object output for the 
Series/ 1 . The source input to the host assembler is coded in 
Event Driven Language or Series/ 1 assembler language. The 
host assembler refers to the System /370 Program Preparation 
Facility (5798-NNQ). 

host system. Any system whose resources are used to perform 
services such as program preparation for a Series/ 1 . It can be 
connected to a Series/ 1 by a communications link. 

lACB. See indexed access control block. 

lAR. See instruction address register. 

ICB. See indexed access control block. 

MB. See interrupt information byte. 



image store. 

image table. 



The area in a 4978 that contains the character 



immediate data. A self-defining term used as the operand of an 
instruction. It consists of numbers, messages or values which 
are processed directly by the computer and which do not serve as 
addresses or pointers to other data in storage. 

index. In an indexed file, an ordered collection of pairs of keys 
and pointers, used to sequence and locate records. 

index blocl<. In an indexed file, an area that contains control 
information and index entries. These blocks are a multiple of 256 
bytes. 

indexed access control block (lACB/ICB). The control block 
that relates an application program to an indexed file. 

indexed access method. An access method for direct or 
sequential processing of fixed-length records by use of a 
record's key. 

indexed data set. Synonym for indexed file. 

indexed file. A file specifically created, formatted and used by 
the Indexed Access Method. An indexed file is sometimes called 
an indexed data set. 



index register (#1, #2). Two words defined in EDL and 
contained in the task control block for each task. They are used 
to contain data or for address computation. 

input buffer. (1) See buffer. (2) In the Multiple Terminal 
Manager, an area for terminal input and output. 

input output control block (lOCB). A control block containing 
information about a terminal such as the symbolic name, size and 
shape of screen, the size of the forms in a printer, or an optional 
reference to a user provided buffer. 

instruction address register (lAR). The pointer that identifies 
the machine instruction currently being executed. The Series/ 1 
maintains a hardware lAR to determine the Series/ 1 assembler 
instruction being executed. It is located in the level status block 
(LSB). 

integer. A positive or negative number that has no decimal 
point. 

interactive. The mode in which a program conducts a 
continuous dialogue between the user and the system. 

internal label. An area on tape used to record identifying 
information (similar to the identifying information placed on an 
external label). Internal labels are checked by the system to 
ensure that the correct volume is mounted. 

interrupt information byte (IIB). In the Multiple Terminal 
Manager, a word containing the status of a previous input/output 
request to or from a terminal. 

invoke. To load and activate a program, utility, procedure, or 
subroutine into storage so it can run. 

job. A collection of related program execution requests 
presented in the form of job control statements, identified to the 
jobstream processor by a JOB statement. 

job control statement. A statement in a job that specifies 
requests for program execution, program parameters, data set 
definitions, sequence of execution, and, in general, describes the 
environment required to execute the program. 

job stream processor. The job processing facility that reads job 
control statements and processes the requests made by these 
statements. The Event Driven Executive job stream processor is 
$JOBUTIL 

jumper. (1) A wire or pair of wires which are used for the 
arbitrary connection between two circuits or pins in an 
attachment card. (2) To connect wire(s) to an attachment card or 
to connect two circuits. 



c 
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index entry. In an indexed file, a key-pointer pair, where the 
pointer is used to locate a lower-level index block or a data block. 



key. In the Indexed Access Method, one or more consecutive 
characters used to identify a record and establish its order with 
respect to other records. See also key field. 
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key field. A field, located in the same position in each record of 
an indexed file, whose content is used for the key of a record. 

level status block (LSB). A Series/1 hardware data area that 
contains processor status. This area is eleven words in length. 

library. A set of contiguous records within a volume. It contains 
a directory, data sets and /or available space. 

line. A string of characters accepted by the system as a single 
input from a terminal; for example, all characters entered before 
the carriage return on the teletypewriter or the ENTER key on the 
display station is pressed. 



multiple terminal manager. An Event Driven Executive licensed 
program that provides support for transaction-oriented 
applications on a Series/ 1 . It provides the capability to define 
transactions and manage the programs that support those 
transactions. It also manages multiple terminals as needed to 
support these transactions. 

multivolume file. A data file that, due to its size, requires more 
than one unit of recording media (such as tape reel or disk pack) 
to contain the entire file. 

new high key. A key higher than any other key in an indexed 
file. 



link edit. The process of resolving external symbols in one or 
more object modules. A link edit is performed with $EDXLINK 
whose output is a loadable program. 



nonlabeled tapes. Tapes that do not contain identifying labels 
(as in standard labeled tapes) and contain only files separated by 
tapemarks. 



listener. A controller or active device on a GPIB bus that is 
configured to accept information from the bus. 



null character. A user-defined character used to define the 
unprotected fields of a formatted screen. 






load mode. In the Indexed Access Method, the mode in which 
records are loaded into base record slots in an indexed file. 

load module. A single module having cross references resolved 
and prepared for loading into storage for execution. The module 
is the output of the $UPDATE or $UPDATEH utility. 

load point. (1) Address in the partition where a program is 
loaded. (2) A reflective marker placed near the beginning of a 
tape to indicate where the first record is written. 

lock. In the Indexed Access Method, a method of indicating that 
a record or block is in use and is not available for another request. 

logical screen. A screen defined by margin settings, such as the 
TOPM, BOTM, LEFTM and RIGHTM parameters of the 
TERMINAL or lOCB statement. 

LSB. See level status block. 

mapped storage. The processor storage that you defined on the 
SYSTEM statement during system generation. 

member. A term used to identify a named portion of a 
partitioned data set (PDS). Sometimes member is also used as a 
synonym for a data set. See data set. 



option selection menu. A full screen display used by the 
Session Manager to point to other menus or system functions, 
one of which is to be selected by the operator. (See primary 
option rrienu and secondary option menu.) 

output buffer. (1) See buffer. (2) In the Multiple Terminal 
Manager, an area used for screen output and to pass data to 
subsequent transaction programs. 

overlay. The technique of reusing a single storage area allocated 
to a program during execution. The storage area can be reused 
by loading it with overlay programs that have been specified in 
the PROGRAM statement of the program or by calling overlay 
segments that have been specified in the OVERLAY statement of 
$EDXLINK. 

overlay area. A storage area within a program reserved for 
overlay programs specified in the PROGRAM statement or 
overlay segments specified in the OVERLAY statement in 
$EDXLINK. 

overlay program. A program in which certain control sections 
can use the same storage location at different times during 
execution. An overlay program can execute concurrently as an 
asynchronous task with other programs and is specified in the 
EDL PROGRAM statement in the main program. 



menu. A formatted screen image containing a list of options. 
The user selects an option to invoke a program. 

menu-driven. The mode of processing in which input consists of 
the responses to prompting from an option menu. 

message. In data communications, the data sent from one 
station to another in a single transmission. Stations 
communication with a series of exchanged messages. 

multifile volume. A unit of recording media, such as tape reel or 
disk pack, that contains more than one data file. 



overlay segment. A self-contained portion of a program that is 
called and sequentially executes as a synchronous task. The 
entire program that calls the overlay segment need not be 
maintained in storage while the overlay segment is executing. An 
overlay segment is specified in the OVERLAY statement of 
$EDXLINK or$XPSLINK (for initialization modules). 

overlay segment area. A storage area within a program or 
supervisor reserved for overlay segments. An overlay segment 
area is specified with the OVLAREA statement of $EDXLINK. 
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parameter selection menu. A full screen display used by the 
Session Manager to indicate the parameters to be passed to a 
program. 

partition. A contiguous fixed-sized area of storage. Each 
partition is a separate address space. 

performance volume. A volume whose name is specified on 
the DISK definition statement so that its address is found during 
I PL, increasing system performance when a program accesses 
the volume. 

physical timer. Synonym for timer (hardware). 

polling. In data communications, the process by which a 
multipoint control station asks a tributary if it can receive 
messages. 

precision. The number of words in storage needed to contain a 
value in an operation. 

prefind. To locate the data sets or overlay programs to be used 
by a program and to store the necessary information so that the 
time required to load the prefound items is reduced. 

primary file. An indexed file containing the data records and 
primary index. 

primary file entry. For the Indexed Access Method Version 2, 
an entry in the directory describing a primary file. 

primary index. The index portion of a primary file. This is used 
to access data records when the primary key is specified. 

primary key. In an indexed file, the key used to uniquely identify 
a data record. 

primary-level index block. In an indexed file, the lowest level 
index block. It contains the relative block numbers (RBNs) and 
high keys of several data blocks. See cluster. 

primary menu. The program selection screen displayed by the 
Multiple Terminal Manager. 

primary option menu. The first full screen display provided by 
the Session Manager. 

primary station. In a Series/1 -to-Series/1 Attachment, the 
processor that controls communication between the two 
computers. Contrast with secondary station. 

primary task. The first task executed by the supervisor when a 
program is loaded into storage. It is identified by the PROGRAM 
statement. 

priority. A combination of hardware interrupt level priority and a 
software ranking within a level. Both primary and secondary 
tasks will execute asynchronously within the system according to 
the priority assigned to them. 



process mode. In the Indexed Access Method, the mode in 
which records can be retrieved, updated, inserted, or deleted. 

processor status word (PSW). A 16-bit register used to (1) 
record error or exception conditions that may prevent further 
processing and (2) hold certain flags that aid in error recovery. 

program. A disk- or diskette- resident collection of one or more 
tasks defined by a PROGRAM statement; the unit that is loaded 
into storage. (See primary task and secondary task.) 

program header. The control block found at the beginning of a 
program that identifies the primary task, data sets, storage 
requirements and other resources required by a program. 

program/storage manager. A component of the Multiple 
Terminal Manager that controls the execution and flow of 
application programs within a single program area and contains 
the support needed to allow multiple operations and sharing of 
the program area. 

protected field. A field in which the operator cannot use the 
keyboard to enter, modify, or erase data. 

PSW. See processor status word. 

QCB. See queue control block. 

QD. See queue descriptor. 

QE. See queue element. 

queue control block (QCB). A data area used to serialize access 
to resources that cannot be shared. See serially reusable 
resource. 

queue descriptor (QD). A control block describing a queue built 
by the DEFINEQ instruction. 

queue element (QE). An entry in the queue defined by the 
queue descriptor. 

quiesce. To bring a device or a system to a halt by rejection of 
new requests for work. 

quiesce protocol. A method of communication in one direction 
at a time. When sending node wants to receive, it releases the 
other node from its quiesced state. 

record. (1 ) The smallest unit of direct access storage that can be 
accessed by an application program on a disk or diskette using 
READ and WRITE. Records are 256 bytes in length. (2) In the 
Indexed Access Method, the logical unit that is transferred 
between $IAM and the user's buffer. The length of the buffer is 
defined by the user. (3) In BSCAM communications, the portions 
of data transmitted in a message. Record length (and, therefore, 
message length) can be variable. 

recovery. The use of backup data to re-create data that has 
been lost or damaged. 
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reflective marker. A small adhesive marker attached to the 
reverse (nonrecording) surface of a reel of magnetic tape. 
Normally, two reflective markers are used on each reel of tape. 
One indicates the beginning of the recording area on the tape 
(load point), and the other indicates the proximity to the end of 
the recording area (eot) on the reel. 

relative blocl< address (RBA). The location of a block of data on 
a 4967 disk relative to the start of the device. 

relative record number. An integer value identifying the 
position of a record in a data set relative to the beginning of the 
data set. The first record of a data set is record one, the second 
is record two, the third is record three. 

relocation dictionary (RLD). The part of an object module or 
load module that is used to identify address and name constants 
that must be adjusted by the relocating loader. 

remote management utility control block (RCB). A control 
block that provides information for the execution of remote 
management utility functions. 

reorganize. The process of copying the data in an indexed file to 
another indexed file in a manner that rearranges the data for more 
optimum processing and free space distribution. 

restart. Starting the spool facility w the spool data set contains 
jobs from a previous session. The jobs in the spool data set can 
be either deleted or printed when the spool facility is restarted. 

return code. An indicator that reflects the results of the 
execution of an instruction or subroutine. The return code is 
usually placed in the task code word (at the beginning of the task 
control block). 

roll screen. A display screen which is logically segmented into 
an optional history area and a work area. Output directed to the 
screen starts display at the beginning of the work area and 
continues on down in a line-by-line sequence. When the work 
area gets full, the operator presses enter/send and its contents 
are shifted into the optional history area and the work area itself 
is erased. Output now starts again at the beginning of the work 
area. 

SBIOCB. See sensor based I/O control block. 

second-level index block. In an indexed data set, the 
second-lowest level index block. It contains the addresses and 
high keys of several primary-level index blocks. 

secondary file. See secondary index. 

secondary index. For the Indexed Access Method Version 2, an 
indexed file used to access data records by their secondary keys. 
Sometimes called a secondary file. 

secondary index entry. For the Indexed Access Method 
Version 2, this an an entry in the directory describing a secondary 
index. 



secondary key. For the Indexed Access Method Version 2, the 
key used to uniquely identify a data record. 

secondary option menu. In the Session Manager, the second in 
a series of predefined procedures grouped together in a 
hierarchical structure of menus. Secondary option menus provide 
a breakdown of the functions available under the session 
manager as specified on the primary option menu. 

secondary task. Any task other than the primary task. A 
secondary task must be attached by a primary task or another 
secondary task. 

secondary station. In a Series/1 -to-Series/1 Attachment, the 
processor that is under the control of the primary station. 

sector. The smallest addressable unit of storage on a disk or 
diskette. A sector on a 4962 or 4963 disk is equivalent to an 
Event Driven Executive record. On a 4964 or 4966 diskette, two 
sectors are equivalent to an Event Driven Executive record. 

selection. In data communications, the process by which the 
multipoint control station asks a tributary station if it is ready to 
send messages. 

self-defining term. A decimal, integer, or character that the 
computer treats as a decimal, integer, or character and not as an 
address or pointer to data in storage. 

sensor based I/O control block (SBIOCB). A control block 
containing information related to sensor I/O operations. 

sequential access. The processing of a data set in order of 
occurrence of the records in the data set. (1 ) In the Indexed 
Access Method, the processing of records in ascending collating 
sequence order of the keys. (2) When using read/write, the 
processing of records in ascending relative record number 
sequence. 

serially reusable resource (SRR). A resource that can only be 
accessed by one task at a time. Serially reusable resources are 
usually managed via (1) a qcb and enq/deq statements or (2) an 
ECB and WAIT/POST statements. 

service request. A device generated signal used to inform the 
GPiB controller that service is required by the issuing device. 

session manager. A series of predefined procedures grouped 
together as a hierarchical structure of menus from which you 
select the utility functions, program preparation facilities, and 
language processors needed to prepare and execute application 
programs. The menus consist of a primary option menu that 
displays functional groupings and secondary option menus that 
display a breakdown of these functional groupings. 

shared resource. A resource that can be used by more than one 
task at the same time. 
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shut down. See data set shut down. 

source module/program. A collection of instructions and 
statements that constitute the input to a compiler or assembler. 
Statements may be created or modified using one of the text 
editing facilities. 

spool job. The set of print records generated by a program 
(including any overlays) while engueued to a printer designated as 
a spool device. 

spool session. An invocation and termination of the spool 
facility. 

spooling. The reading of input data streams and the writing of 
output data streams on storage devices, concurrently with job 
execution, in a format convenient for later processing or output 
operations. 

SRQ. See service request. 

stand-alone dump. An image of processor storage written to a 
diskette. 

stand-alone dump diskette. A diskette supplied by IBM or 
created by the $DASDI utility. 

standard labels. Fixed length 80-character records on tape 
containing specific fields of information (a volume label 
identifying the tape volume, a header label preceding the data 
records, and a trailer label following the data records). 

static screen. A display screen formatted with predetermined 
protected and unprotected areas. Areas defined as operator 
prompts or input field names are protected to prevent accidental 
overlay by input data. Areas defined as input areas are not 
protected and are usually filled in by an operator. The entire 
screen is treated as a page of information. 

station. In BSCAM communications, a BSC line attached to the 
Series/1 and functioning in a point-to-point or multipoint 
connection. Also, any other terminal or processor with which the 
Series/ 1 communicates. 

subroutine. A sequence of instructions that may be accessed 
from one or more points in a program. 

supervisor. The component of the Event Driven Executive 
capable of controlling execution of both system and application 
programs. 

system configuration. The process of defining devices and 
features attached to the Series/ 1 . 

SYSGEN. See system generation. 

system generation. The processing of defining I/O devices and 
selecting software options to create a supervisor tailored to the 
needs of a specific Series/ 1 hardware configuration and 
application. 



system partition. The partition that contains the root segment 
of the supervisor (partition number 1, address space 0). 

talker. A controller or active device on a GPIB bus that is 
configured to be the source of information (the sender) on the 
bus. 

tape device data block (TDB). A resident supervisor control 
block which describes a tape volume. 

tapemark. A control character recorded on tape used to 
separate files. 

task. The basic executable unit of work for the supervisor. Each 
task is assigned its own priority and processor time is allocated 
according to this priority. Tasks run independently of each other 
and compete for the system resources. The first task of a 
program is the primary task. All tasks attached by the primary 
task are secondary tasks. 

task code word. The first two words (32 bits) of a task's TCB; 
used by the emulator to pass information from system to task 
regarding the outcome of various operations, such as event 
completion or arithmetic operations. 

task control block (TCB). A control block that contains 
information for a task. The information consists of pointers, save 
areas, work areas, and indicators required by the supervisor for 
controlling execution of a task. 

task supervisor. The portion of the Event Driven Executive that 
manages the dispatching and switching of tasks. 

TCB. See task control block. 

terminal. A physical device defined to the EDX system using the 
TERMINAL configuration statement. EDX terminals include 
directly attached IBM displays, printers and devices that 
communicate with the Series/ 1 in an asynchronous manner. 

terminal control block (CCB). A control block that defines the 
device characteristics, provides temporary storage, and contains 
links to other system control blocks for a particular terminal. 

terminal environment block (TEB). A control block that 
contains information on a terminal's attributes and the program 
manager operating under the Multiple Terminal Manager. It is 
used for processing requests between the terminal servers and 
the program manager. 

terminal screen manager. The component of the Multiple 
Terminal Manager that controls the presentation of screens and 
communications between terminals and transaction programs. 

terminal server. A group of programs that perform all the 
input/output and interrupt handling functions for terminal devices 
under control of the Multiple Terminal Manager. 
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terminal support. The support provided by EDX to manage and 
control terminals. See terminal. 

timer. The timer features available with the Series/ 1 processors. 
Specifically, the 7840 Timer Feature card (4955 only) or the native 
timer (4952, 4954, and 4956). Only one or the other is supported 
by the Event Driven Executive. 

trace range. A specified number of instruction addresses within 
which the flow of execution can be traced. 

transaction oriented applications. Program execution driven by 
operator actions, such as responses to prompts from the system. 
Specifically, applications executed under control of the Multiple 
Terminal Manager. 

transaction program. See transaction -oriented applications. 

transaction selection menu. A Multiple Terminal Manager 
display screen (menu) offering the user a choice of functions, 
such as reading from a data file, displaying data on a terminal, or 
waiting for a response. Based upon the choice of option, the 
application program performs the requested processing 
operation. 

tributary station. In BSCAM communications, the stations 
under the supervision of a control station in a multipoint 
connection. They respond to the control station's polling and 
selection. 

unmapped storage. The processor storage in your processor 
that you did not define on the SYSTEM statement during system 
generation. 

unprotected field. A field in which the operator can use the 
keyboard to enter, modify or erase data. Also called 
non-protected field. 



update. (1) To alter the contents of storage or a data set. (2) To 
convert object modules, produced as the output of an assembly 
or compilation, or the output of the linkage editor, into a form that 
can be loaded into storage for program execution and to update 
the directory of the volume on which the loadable program is 
stored. 

user exit. (1) Assembly language instructions included as part of 
an EDL program and invoked via the USER instruction. (2) A 
point in an IBM-supplied program where a user written routine 
can be given control. 

variable. An area in storage, referred to by a label, that can 
contain any value during program execution. 

vary offline. (1) To change the status of a device from online to 
offline. When a device is offline, no data set can be accessed on 
that device. (2) To place a disk or diskette in a state where it is 
unknown by the system. 

vary online. To place a device in a state where it is available for 
use by the system. 



vector. An ordered set or string of numbers. 

volume. A disk, diskette, or tape subdivision defined using 
$INITDSKor$TAPEUT1. 

volume descriptor entry (VDE). A resident supervisor control 
block that describes a volume on a disk or diskette. 

volume label. A label that uniquely identifies a single unit of 
storage media. 
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The following index contains entries for this book only. 
Index to all Event Driven Executive books. 



See the Library Guide and Common Index for a Common 






Special Characters 

$A - list partitions and programs 

syntax UT-13 
$B - blank display screen 

syntax UT-14 
$BSCTRCE utility 

description UT-46 

invoking UT-46 
$BSCUT1 utility 

commands UT-48 

description UT-48 

invoking UT-48 
$BSCUT2 utility 

change hard-copy device UT-53 

commands UT-53 

description UT-51 

invoking UT-52 

test pattern messages UT-51 
$C - cancel program 

syntax UT-15 
$CHANUT1 utility 

change device address UT-61 

description UT-61 

displaying commands UT-61 

enable/disable trace UT-62 

I/O trace UT-61 

invoking UT-61 

print trace area UT-62 

start channel attach device UT-62 

stop channel attach device UT-62 

terminate utility UT-62 



trace example UT-63 
SCOMPRES utility 
compress 

a volume UT-70 

device with fixed-head volumes UT-67 

IPL volume UT-71 
description UT-64 

estimate progress of compress UT-68 
invoke UT-65 
$COPY utility 
copy 

data set UT-74 

from basic exchange UT-78 

to basic exchange UT-79 

volume UT-76 
copy to a different size data set UT-72 
invoking UT-73 
$C0PYUT1 utility 
copy 

all data sets UT-85 

all programs UT-87 

data members UT-85 

data sets not starting with a prefix UT-89 

member UT-88 

members beginning with a prefix UT-88 

multiple data sets UT-83 

one data set UT-88 
copy mode 

change source and target volumes UT-82 

copy all UT-82 

description UT-82 

read verify UT-82 
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turn off roll screen UT-82 

turn on roll screen UT-82 

verify member copy UT-82 

write verify UT-82 
copy to a different size data set UT-80 
description UT-80 
invoking UT-80 
$CP - change terminal partition 

syntax UT-15 
$D - dump storage 
syntax UT-16 
$DASDI utility 

creating stand-alone dump/ UT-91 

description UT-90 

format 

30-megabytedisk(DDSK-30) UT-117 

60-megabytedisk(DDSK-60) UT-117 
initialize 

diskettes UT-94 

2 diskettes for a dump >512K UT-92 

30-megabyte disk (DDSK-30) UT-117 

4962 disk UT-101 

4963 disk UT-105 
4967 disk UT-109 

60-megabyte disk (DDSK-60) UT-117 
invoking UT-90 

operating characteristics for diskette initialization UT-96 
$DEBUG utility 

activate a stopped task UT- 1 34 
change 

execution sequence UT-135 

registers UT-139 

storage UT-139 
close spool job created by $DEBUG UT-132 
data necessary for debugging UT- 1 27 
description UT-126 
direct output UT-142 
display 

status of tasks UT-143 

storage or registers UT- 1 36 
ending UT-133 
features UT-126 
list 

breakpoints and trace ranges UT-132 

commands UT-135 

unmapped storage UT-136 
modify base address UT-142 
patch unmapped storage UT-139 
post 

event UT-141 

process interrupt UT-141 
remove breakpoints and trace ranges UT-138 
set 

breakpoints UT-130 

trace ranges UT-130 
$DICOMP utility 

add a new member to data base UT-145 
alter an existing member UT-145 
description UT-144 
display commands UT-144 



insert/delete elements in existing member UT-146 

invoking UT-144 

print member formatted UT-147 

subcommands 

advance X,Y coordinates UT-149 

define multiple realtime data members UT-159 

description UT-147 

direct graphics output UT-149 

display characters UT-155 

display time and date UT- 1 59 

display variable UT-159 

draw a line to X,Y coordinates UT- 1 55 

draw a symbol UT-149 

draw line relative to current position UT-1 56 

end display UT-1 54 

exit program without update to data base UT-1 54 

insert member UT-1 54 

jump reference UT-155 

jump to address UT- 1 54 

move beam to X,Y coordinates UT-1 57 

plot curve only UT-1 57 

plot data UT-1 57 

save completed display profile UT-159 

send data UT-1 54 
test display as entered UT-147 
$DI I NTR utility UT-161 
$DIRECT utility 

alphabetical order sort UT-1 69 

change volume for directory sort UT- 1 70 

description UT-1 68 

end utility UT-1 71 

invoking UT-1 68 

list all data sets in volume UT-1 72 

sort 

by ascending data set size UT-1 72 

by descending data set size UT-1 73 

by location UT-1 70 

directory in predefined order UT-1 74 

interactively UT-1 76 
$DISKUT1 utility 
change 

volume UT-1 81 

volume being accessed UT-1 81 
delete 

all members starting with prefix UT-1 82 

data sets UT-1 81 

data sets not starting with prefix UT-1 83 

generic in prompt mode UT-1 82, UT-1 83 

programs not starting with prefix UT-1 84 

programs starting with prefix UT-1 82 
description UT-1 77 

determine free space on a volume UT-1 95 
direct output UT-1 91 
end utility UT-1 84 

free space available in volume UT-1 95 
invoking UT-1 77 
list directory 

all data sets in CTS/RBA mode UT-185 

all members UT-1 84 

all members in CTS/RBA mode UT-185, UT-1 90 
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all members on a volume UT-184 

data sets on all volumes UT-187 

data sets starting with specific prefix UT- 1 87 

data -type data sets UT-189 

data-type data sets in CTS/RBA mode UT-189 

free space available in volume UT-195 

one data set UT-191 

program-type data sets UT-193 

program-type data sets in CTS/RBA mode UT-194 

volumes UT-184, UT-188 
renaming data sets UT-196 
reset prompt mode UT-197 
set 

end of data pointer/flag UT-196 

prompt mode UT-197 
$DISKUT2 utility 

change volume UT-201 
clear a data set UT-201 
description UT-198 
end utility UT-206 
invoking UT-199 
list 

all/portion of data set on printer UT-208 

data set on terminal UT-210 

data -type data set UT-202, UT-203 

log by relative record for a device UT-218 

log by relative record for a terminal UT-209 

log by wrap count for a device UT-21 8 

log by wrap count for a terminal UT-209 

log data set UT-207, UT-21 6 

program-type data set UT-202, UT-203 

source data set UT-210 
patch a data set/program UT-21 1 
set program storage parameter UT-21 9 
$DIUTIL utility 

allocate data member UT-221 
build data member UT-222 
compress data base UT-223 
copy member UT-223 
delete a member UT-224 
description UT-220 
display 

data base status UT-227 

directory UT-225 

member header UT-225 
end utility UT-224 
initialize data base UT-224 
invoking UT-220 
move data base UT-226 
rename member UT-227 
$DU MP utility 

description UT-228 
invoking UT-228 
print a dump UT-228 
storage 

STRAP output UT-228 

stand-alone dump UT-228 

unmapped UT-228 
unmapped storage UT-228 
$E - eject printer page 



syntax UT-16 
$EDIT1/$EDIT1N utility 

add /replace text UT-254 
command syntax 

EDIT UT-239 

EDIT mode subcommands UT-247 

END UT-240 

LIST UT-241 

READ UT-242 

SUBMIT UT-244 

WRITE UT-245 
control keys UT-238 
data set requirements UT-235 
description UT-235, UT-238 
display changes to work data set UT-263 
end utility UT-240 
enter edit mode UT-239 
find a character string UT-253 
invoking UT-235 
line editing commands UT-264 
list work data set UT-241, UT-255 
move 

line pointer up UT-262 

text UT-256 
position line pointer UT-262 
renumber work data set UT-257 
retrieve 

host data set UT-242 

Series /I data set UT-243 
save work data set UT-258 
sequence of operations UT-236 
set tabs UT-259 
submit job to host UT-244 
write 

work data set to host UT-245 

work data set to Series /I data set UT-246 
$EDXASM utility 

description UT-265 
invoking with $L UT-268 
language-control data set UT-265 
listing program ($EDXLIST) UT-271 
options UT-266 
output UT-270 
overview UT-265 
required data sets UT-265 
using the compiler UT-266 
$EDXL language control data set UT-265 
$EDXLINK utility 

AUTOCALL option 

data set UT-294 

data set record format UT-294 

processing UT-295 

system data set UT-294 
control statement data sets UT-295 
control statements 

AUTOCALL UT-277 

comment UT-277 

COPY UT-278 

END UT-279 

INCLUDE UT-279 
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LINK UT-280 

OVERLAY UT-282 

OVLAREA UT-281 

RESET UT-282 

UNMAPCNT UT-283 

VOLUME UT-284 
data sets required UT-275 
define 

overlay area UT-281 

overlay segment UT-282 

overlay segments in unmapped storage UT-283 
identify 

autocall data sets UT-277 

comments UT-277 

end-of-control-statement data set UT-279 
include object modules UT-279 
invoke using 

$L interactive UT-288 

$L noninteractive UT-288 
link map UT-292 
operator termination UT-291 
perform a link-edit UT-280 

primary-control-statement data set UT-275, UT-284 
requesting a link-edit UT-287 
reset $EDXLINK UT-282 

secondary-control-statement data set UT-275, UT-286 
set default volume UT-284 
specifying dynamic storage UT-286 
$EDXLIST program UT-272 
$FONT utility 

create/modify a character image UT-306 
data set requirements UT-296 
display current image UT-297 
enter edit mode UT-299 
get image store from device UT-301 
invoking UT-296 

load image store into device UT-302 
pfkeys UT-306 
read a data set UT-304 
save image data set UT-305 
$FSEDIT utility 

data set requirements UT-315 
directory line commands UT-325 
directory list 

change volume UT-321 

display end of list UT-320 

locate a specific data set UT-323 

return to beginning of list UT-324 

sort list UT-324 
edit line commands 

copy block(s) of data UT-345 

define copy or move UT-345 

delete block(s) of text UT-347 

description UT-344 

display column setting UT-346 

display insert mask UT-350 

insert blocks of text UT-349 

insert new line UT-348 

move block(s) of text UT-351 

shift left UT-345 



shift right UT-345 
edit upper/lowercase data UT-330 
invoking UT-312 
overview UT-312 
primary commands UT-331 

cancel browse/edit mode UT-335 

change text UT-337 

clear work data set UT-338 

description UT-334 

end browse/edit mode UT-339, UT-341 

find a specific text string UT-340 

locate a line number UT-341 

print contents of work data set UT-342 

renumber lines within work data set UT-342 

reset line commands UT-343 

save contents of work data set UT-344 

set COBOL line numbers UT-339 

set tabs in edit work data set UT-343 

set uppercase conversion UT-335 
primary options 

browse a data set UT-327 

create a source data set UT-328 

display tutorial text UT-333 

edit a source data set UT-327 

end utility UT-333 

merge data sets UT-332 

modify an existing source data set UT-329 

print contents of work data set UT-332 

retrieve a source data set UT-331 

submit a job to host job stream UT-332 

write a source data set to another data set UT-331 
program function (PF) keys UT-317 
scrolling UT-316 
work data set UT-315 
$GPIBUT1 utility 

change partition UT-353 
define 

device UT-354 

end character UT-353 
description UT-352 
displaying commands UT-352 
end utility UT-354 
example UT-360 
GPIB control UT-354 
invoking UT-352 
list device control block UT-355 
post GPIB operation complete UT-360 
read 

data UT-357 

error status UT-358 
reset GPIB adapter UT-358 
resume utility operation UT-360 
suspend utility UT-359 
write data to the GPIB adapter UT-359 
$HCFUT1 utility 

description UT-366 

invoking UT-366 

release status record UT-368 

set status UT-368 

status commands UT-368 
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submit job to host job stream UT-368 
transfer 

data set from host to Series/ 1 UT-367 

data set from Series/ 1 to host UT-369 

records from host to Series/ 1 UT-367 
$HXUT1 utility 

allocate H -exchange data set UT-374 
change to another volume UT-376 
copy 

to EDX data set UT-379 

to H -exchange data set UT-384 
delete data set UT-376 
description UT-371 
initialize volume UT-376 
invoking UT-372 
list 

contents of volume UT-377 

space in volume UT-378 
redirect listing to another terminal UT-377 
rename an H-exchange volume UT-378 
update 

data set label by name UT-382 

data set label by number UT-383 

volume label UT-383 
using UT-373 
$IMAGE utility 
define 

attribute characters UT-391 

null character UT-395 

screen dimensions UT-392 
description UT-386 
display 

field table UT-393 

how to UT-390 

PF key functions UT-394 
end utility UT-393 
enter screen mode UT-392 
invoking UT-389 
print images and tables UT-396 
program function keys UT-399 
save screen format UT-397 
set 

horizontal tabs UT-394 

vertical tabs UT-399 
$INITDSK utility 
allocate 

fixed-head volume UT-404 

volume UT-404 
define additional volume UT-420 
delete volumes UT-406 
description UT-402 
displaying commands UT-403 
initialize 

device UT-407 

I PL text UT-412 

volume directories UT-407 
invoking UT-402 

listing volume directories UT-414, UT-416 
rename 

diskette vol 1 /ownerid UT-419 



volumes UT-419 
split a volume UT-420 
verify 

device UT-421 

volume UT-421 
write 

data set directory on volume UT-413 
$IOTEST utility 

description UT-423 
displaying commands UT-424 
invoking UT-423 
list 

devices attached to Series/ 1 UT-427 

devices supported by supervisor UT-428 
$JOBQUT utility 

change logging terminal UT-432 
delete job queues UT-433 
description UT-430 
displaying 

commands UT-431 

the status UT-430 
end 

job queue processing UT-436 

utility UT-433 
initialize job queue data set UT-434 
invoking UT-430 

resume job queue processing UT-434 
suspend 

job queue processing UT-434 

utility UT-433 
$JOBUTIL utility 

allocate a data set UT-439 
command syntax UT-438 
description UT-437 
display message UT-453 
end 

job UT-443 

nested procedure UT-443 
enter $JOBUTIL commands manually UT-449 
execute 

procedure UT-451 

program UT-444 
identify 

continuation point UT-446 

job to be executed UT-444 

parameters to be passed UT-449 

program to be executed UT-452 
indicate internal comments UT-454 
invoking UT-437 
jump to label UT-445 
log control commands UT-447 
set no message logging UT-448 
setup procedure UT-437 
starting 

new page in log listing UT-442 

with$L UT-437 
usage example UT-455 
$L - load program 
syntax UT-17 
$LOG utility 
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CIRCBUFF UT-457 

commands UT-458 

description UT-457 

invoking UT-457 

log data set UT-457 

remote manager user requirements UT-457 
$MEMDISK utility 

allocate unmapped storage as a disk UT-460 

commands UT-460 

delete MEMDSK UT-461 

initialize MEMDSK UT-461 

invoking UT-460 

reset $LOADER to load from disk UT-462 

reset system default volume UT-462 

set $LOADER to load from MEMDISK UT-463 

set default volume to MEMDSK UT-462 
$MOVEVOL utility 

data set names required UT-465 

description UT-464 

diskette usage 

contents UT-464 

format UT-464 

4966 considerations UT-464 

dump procedure UT-465 

invoking UT-464 

restoring a system UT-468 

saving a system UT-465 
$MSGUT1 utility 

description UT-470 

displaying commands UT-470 

end utility UT-471 

format messages UT-471, UT-474 

invoking UT-470 

messages 

disk-resident UT-471 
storage- resident UT-474 

print messages UT-473 
$P - patch storage 

syntax UT-18 
$PFMAP utility 

description UT-475 

invoking UT-475 
$PREFIND utility 

commands UT-477 

description UT-476 

invoking UT-476 

program load process UT-476 
$PRT2780 utility 

invoking UT-481 

sample remote job entry session UT-482 
$PRT3780 utility 

invoking UT-481 

sample remote job entry session UT-482 
$RJE2780 utility 

define 

data to host UT-488 

disk(ette) to receive data from host UT-487 
spool file to receive data from host UT-488 
terminal for output UT-486 

description UT-484 



end 

spooling of printer output UT-486 

utility UT-486 
host subsystems UT-484 
invoking UT-485 
reset utility functions UT-487 
stop data transmission UT-486 
suspend 

data to host UT-488 

single card image record to host UT-486 
$RJE3780 utility 
define 

data to host UT-488 

disk(ette) to receive data from host UT-487 

spool file to receive data from host UT-488 

terminal for output UT-486 
description UT-484 
end 

spooling of printer output UT-486 

utility UT-486 
host subsystems UT-484 
invoking UT-485 
reset utility functions UT-487 
send 

data to host UT-488 

single card image record to host UT-486 
stop data transmission UT-486 
$S - control printer spooling 
ALT, alter printing 

syntax UT-20 
DALL, delete all jobs 

syntax UT-21 
DE, delete one job 

syntax UT-22 
DG, delete jobs by prefix 

syntax UT-22 
DISP, display status 

syntax UT-23 
HOLD, hold job 

syntax UT-23 
KEEP, keep/release job 

syntax UT-24 
REL, release jobs 

syntax UT-24 
STOP, stop spooling 

syntax UT-25 
WRES, restart writer 

syntax UT-25 
WSTP, stop writer 

syntax UT-26 
WSTR, start writer 

syntax UT-27 
$SMMAIN load session manager 

See session manager 
$SMMLOG session manager logon menu 

See session manager 
$SMMPRIM primary option menu 

See session manager 
$SPLUT1 utility 

functions UT-489 
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invoking UT-491 
$STGUT1 utility 

description UT-497 

displaying commands UT-497 

free storage UT-499 

invoking UT-497 

list 

segmentation registers UT-498 
unmapped storage information UT-501 
$SUBMIT utility 

delete a job UT-504 

description UT-503 

display 

commands UT-504 

status of job queue processing UT-508 

end utility UT-505 

hold a batch job UT-506 

invoking UT-503 

release a held job UT-506 

resume utility processing UT-505 

submit 

and hold a batch job UT-507 

job for execution UT-506 

job to job queue processor UT-503 

suspend utility UT-505 
$S1ASM utility 

assembler options UT-510 

data sets required UT-509 

description UT-509 

invoking UT-509 

output UT-516 
$S1S1UT1 utility 

define device name UT-518 

description UT-517 

displaying commands UT-517 

echo test UT-518 

end utility UT-519 

invoking UT-517 

I PL the other processor UT-519 

obtain status UT-520 

perform write abort UT-518 

read data UT-520 

reset device UT-520 

write data UT-521 
$T - set date, time 

syntax UT-27 
$TAPEUT1 utility 

allocate a data set UT-547 

automatic initialization mode UT-543 

backup volume on tape UT-542 

change 

tape drive attributes UT-526 

control tape motion UT-536 

copy a data set UT-523 

description UT-522 

display 

commands UT-523 
tape return codes UT-538 

double-buffered function UT-539 

dump tape records UT-527 



exercise tape UT-528 

initialize a tape UT-531 

initialize tapes automatically UT-543 

invoking UT-522 

list tape drives and attributes UT-535 

monitor save or restore process UT-539 

nonautomatic initialization mode UT-545 

restore 

data set UT-539 

disk device UT-539 

multiple tapes UT-542 

volume UT-539 
save 

data set UT-542 

disk device UT-542 

using multiple tapes UT-546 

volume UT-542 
single-buffered function UT-539 
vary tape online automatically UT-540 
$TERMUT1 utility 

assign printer for spooling output UT-548 
change 

hard-copy device UT-556 

page formatting parameters UT-548 

print PF key UT-556 

terminal address UT-555 
description UT-548 
end utility UT-552 
invoking UT-548 

list a terminal's name/type/address UT-552 
rename a terminal UT-555 
vary 

terminal offline UT-553 

terminal online UT-554 
$TERIV1UT2 utility 

assign a DEFINE key UT-560 
change a key definition UT-561 
description UT-557 
displaying commands UT-559 
end utility UT-566 
invoking UT-559 
load 

control store UT-567 

image store UT-568 

4980 terminal UT-569 
required data sets UT-558 
reserved data set names UT-558 
restore 

original character set to 4974 printer UT-570 

4974 image UT-557 
save 

control store UT-571 

image store UT-572 
scan codes 

for the 4978 UT-564 

for the 4980 UT-565 
4978 support UT-557 
4978/4980 keyboards UT-563 
$TERMUT3 utility 

description UT-573 
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invoking UT-573 
$TRACEIO utility 

description UT-576 

display trace data set UT-577 

dump trace buffer UT-577 

end utility UT-578 

invoking UT-576 

repeat communication line trace UT-579 

trace activities on a communications line UT-579 
$TRANS utility UT-581 

copy/send/transmit data across a bisync Line UT-581 

description UT-581 

invoking UT-581 
STRAP utility 

allocate work data set UT-590 

attention commands 

description UT-589 

dump mapped and unmapped storage to work data 
set UT-589 

ending UT-593 

error conditions UT-591 

forcing a dump UT-593 

loading UT-590 

starting UT-593 

suspending UT-593 
$U operator command 

description UT-28 
$UPDATE utility 

change volume UT-599 

data sets required UT-598 

description UT-598 

end utility UT-600 

invoking UT-598 

invoking with the session manager UT-602 

output UT-603 

read and store a program UT-600 

update a program using $JOBUTIL UT-602 

use considerations during system generation UT-603 
$UPDATEH utility 

description UT-605 

displaying commands UT-605 

invoking UT-605 
$VARYOFF - set device offline 

syntax UT-28 
$VARYON - set device online 

syntax UT-29 
$W - display date, time 

syntax UT-30 



abort 

Series/1-to-Series/1 write UT-518 
absolute record copy UT-72 
absolute record number 

dump UT-199 

patch UT-199 
ACCA 



communication line, trace activities UT-579 

trace facility UT-576 
activate 

error logging UT-457 

realtime data member UT-159 

stopped task UT-134 

TRAP function of storage dump UT-589 

waiting task UT-141 
add 

member to partitioned data base (graphics) UT-145 

null data set on tape volume UT-547 
advancing printer forms 

$E syntax UT- 1 6 
aligning forms 

for spool jobs UT-20 
allocate 

data set 

creating partitioned ($PDS) UT-221 
using $DISKUT1 UT-177 
using $JOBUTIL UT-439 
using STAPEUTI UT-547 

unmapped storage as a disk UT-460 

volume 

on disk/diskette UT-404 
on fixed- head device UT-404 
alter 

member (graphics) UT-145 

spool job printing 

command syntax UT-20 

terminal configuration UT-548 
alternate session menu, session manager 

defined UT-33 
alternate tracks UT-105 
analog input 

AT $IOTEST command UT-425 
analog output 

AO $IOTEST command UT-424 
assembler 

See $EDXASM and $S1 ASM 
assign 

alternate sector UT-105, UT-115, UT-123 

DEFINE key in control store UT-560 

printer for spooling output UT-548 

priorities to jobs UT-506 
ATTR define attribute characters, $IMAGE command UT-391 
AUTOCALL 

control statement ($EDXLINK) UT-277 

data set ($EDXLINK) UT-294 

data set record format ($EDXLINK) UT-294 

option ($EDXLINK) UT-294 

processing ($EDXLINK) UT-295 
automatic 

inclusion of modules in link edit UT-294 

initialization mode UT-543 
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back up 

disk or diskette volume on tape UT-542 

diskette, $C0PYUT1 UT-80 

diskette, $MOVEVOL UT-464 
background option UT-36 

backup dump restore utility, $MOVEVOL UT-464 
base address, modify UT-142 
basic exchange copy UT-78 
basic exchange diskette 

copying from UT-78 

copying to UT-79 

data set copy utility UT-78 
batch job processing 

See $JOBUTIL utility 
binary synchronous communications (BSC) 

read transparent/nontransparent data UT-54 

read /write 

nontransparent conversational UT-55 
nontransparent data UT-54 
transparent conversational UT-56 
transparent data UT-57 
transparent data, multidrop line UT-58 

testBSCAM UT-51 

trace printing utility, $BSCUT1 UT-48 

trace utility, $BSCTRCE UT-46 

write 

nontransparent data UT-60 
transparent data UT-60 
blanking display screen 

$B syntax UT-14 
breakpoint and trace range 

remove UT-138 

settings UT-130 
browse a data set UT-320, UT-327 
BSC trace records, dump UT-49 
BSF (backward space file) UT-536 
BSR (backward space record) UT-536 
build data member (graphics) UT-222 
BUILD option ($EDXASM) UT-267 
bus 

See General Purpose Interface Bus 



CA attention request 

$EDXASM UT-266 

$EDXLIST UT-272 

$FSEDiT UT-332 
cancel 

browse/edit mode UT-335 

dump UT-229 

job queue jobs UT-504 

print command UT-332 

programs 

$C syntax UT- 1 5 

utilities UT-45 
change 



character string 

with$EDIT1/N UT-248 

with$FSEDIT UT-337 
control store UT-557 
data set name UT-558 
DEBUG base address UT-142 
definition of a key UT-561 
display screen format UT-548 
execution sequence of a program UT-135 
GPIB partition UT-353 
graphics or report display profile UT-144 
hard -copy device 

with$BSCUT2 UT-53 

with $TERMUT1 UT-548 
image store UT-557 
keyboard values UT-561 
page formatting UT-548 
PFkey UT-560 
print screen PF key UT-556 
spool options UT-489 
tape drive attributes UT-526 
tape label UT-531 
terminal 

address UT-555 

configuration UT-548 

displaying job queue status UT-432 

name UT-555 

partition UT-15 
volume 

with $TERMUT1 UT-556 

withCV($BSCUTl) UT-48 

withCV($DlSKUT1) UT-181 

with CV ($DISKUT2) UT-200 

with CV ($UPD ATE) UT-599 
channel attach 

See also $CHANUT1 utility 
description UT-61 
I/O trace UT-61 
character image table, load UT-568 
clear 

data set UT-201 
display screen 

$B syntax UT-14 
work data set UT-338 
write verify UT-422 
comment control statement ($EDXLiNK) UT-277 
communication line, trace activities UT-579 
communications utilities 
$BSCTRCE UT-46 
$BSCUT1 UT-48 
$BSCUT2 UT-51 
$HCFUT1 UT-366 
$PRT2780 UT-481 
$PRT3780 UT-481 
$RJE2780 UT-484 
$RJE3780 UT-484 
$TRANS UT-581 
compile 

a program UT-266 
compiler 
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See $EDXASM utility 
completion codes 

See also post codes, return codes 

for$EDXASM UT-271 

for$UPDATE UT-603 
compress 

disk, diskette, or volume UT-64 

IPL volume UT-64 
configuring 

terminal UT-548 
contents of data set, list UT-210 
control 

job queue processing UT-430 

keys for test editors UT-238 

processing of batch jobs UT-503 

statements, $EDXLINK UT-275 

tape motion UT-536 
CONTROL option ($EDXASM) UT-267 
control store 

changing UT-557 

loading UT-567 

saving UT-571 
convert 

new program with data set allocation UT-601 

object modules to executing code UT-598 

source messages 

to disk- resident format UT-471 
to storage- resident format UT-474 
copy 

basic exchange data set 
from UT-78 
TO UT-79 

block(s) of text UT-345 

copy text UT-249 

data set UT-74 

data set across a bisync line ($TRANS) UT-581 

data sets not starting with a prefix UT-89 

data sets with allocation UT-80 

data to/from non-EDX systems 

basic exchange data set UT-78, UT-79 

diskette data set to tape UT-523 

IPL text to diskette UT-73 

line(s) of text UT-345 

member 

$DIUTIL UT-223 

beginning with a prefix UT-88 

from source to target UT-88 

programs UT-87 

tape data set 

$C0PYUT1 UT-81 
to diskette UT-523 
to tape UT-523 

volume or data set to an allocated volume or data 
set UT-74, UT-76 
COPY control statement ($EDXLINK) UT-278 
create 

source data set UT-328 

stand-alone dump/ UT-91 

upper/ lowercase data set UT-557 
custom menus, session manager UT-36 



cylinder/head/sector UT-104 
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DALL subcommand 
syntax UT-21 
data 

editing UT-312 
data management support 

30-megabyte disk (DDSK-30) 

allocate directory data ($DISKUT1) UT-180 

format disk or diskette ($DASDI) UT-90 

list directory data ($DISKUT1 ) UT- 1 85 
4971 printer 
4975-01 A ASCII printer 

change terminal parameters ($TERMUT1) UT-550 
4978/4980 display station 

change image/control store ($TERMUT2) UT-557 

process character/image tables ($FONT) UT-296 
5219 printer 

change terminal parameters ($TERMUT1) UT-551 
60-megabyte disk (DDSK-60) 

allocate directory data ($DISKUT1) UT-180 

format disk or diskette ($DASDI) UT-90 

list directory data ($DISKUT1) UT-185 
data management utilities 
$COMPRES UT-64 
$COPY UT-72 
$C0PYUT1 UT-80 
$DASDI UT-90 
$DISKUT1 UT-177 
$DISKUT2 UT-198 
$INITDSK UT-402 
$M0VEV0L UT-465 
$TAPEUT1 UT-522 
data set 
allocate 

AL command UT-439 

data-type UT-180 

program-type UT-180 
clear (set to zero) UT-201 
copy 

absolute record UT-72, UT-84 

all data sets from source to target UT-85 

from source to target UT-88 

multiple data sets UT-80 

to basic exchange diskette UT-79 

to tape UT-523 

using $COPY UT-72 

using H-exchange UT-373 

with allocation of target data set UT-80 
data organization UT-180 
delete UT-440 

data member UT-181 

generic UT-182, UT-183 

H-exchange UT-376 
description UT-192 
dump all or portion UT-202, UT-203 
format 
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$FSEDIT UT-315 

$PRT2780 UT-481 

$PRT3780 UT-481 
identify UT-441 
list 

ail members UT-184 

all members in CTS/RBA mode UT-185, UT-190 

data sets starting with specific prefix UT-187 

description of data sets in a volume UT-189 

description of one data set UT-192 

description of program members in volume UT-193 

free space available in volume UT-195 

programs in CTS/RBA mode UT-194 
locating before loading a program UT-476 
organization 

DATA UT-72 

PROGRAM UT-72 
partitioned 

allocate UT-221 

delete UT-224 

rename UT-227 
patch UT-211 

in decimal UT-211 

in EBCDIC UT-211 

in hexadecimal UT-212 
rename UT-196 
set end -of- data UT-196 
data set directory 
listing 

data set list commands UT-319 
data set utilities 

See data management utilities 
date 

directory sort UT-324 
displaying 

command syntax UT-30 
setting 

command syntax UT-27 
DDSK-30 

See 30-megabyte disk (DDSK-30) 
DDSK-60 

See 60- megabyte disk (DDSK-60) 
DE subcommand 

syntax UT-22, UT-440 
using UT-440 
default volume, change UT-284 
defective records, locate UT-421 
define 

device name UT-518 
end character (GPIB) UT-353 
GPIB device UT-354 
horizontal tabs UT-394 
image dimensions UT-392 
null characters UT-395 
overlay area UT-281 

overlay segments in unmapped storage UT-283 
protected fields ($IMAGE) UT-401 
vertical tabs UT-399 
3101 attribute characters UT-391 
define key 



specifying UT-560 
delete 

block(s) of text UT-347 
data set 

on tape UT-547 

with$DISKUT1 UT-181 

with$JOBUTIL UT-440 
elements in graphics member UT-146 
job queue UT-433 
jobs in job queue UT-504 
member 

with ($DIUTIL) UT-224 

with$DISKUT1 UT-181 
text 

with$EDIT1/N UT-250 

with line command ($FSEDIT) UT-347 
volumes UT-406 
density 

for diskette initialization, $DASDI UT-94 
detach 

$SUBMIT UT-505 
determine 
data set 

end-of-data UT-191 

location UT-191 

size UT-191 

type UT-191 
free space on a volume UT-195 
number of 

data sets on a volume UT-195 

directory entries on a volume UT-195 

unused directory entries on a volume UT-195 

unused records on a volume UT-195 
terminal 

address UT-552 

name UT-552 

partition assignment UT-552 

type UT-552 
device 

vary offline 

command syntax UT-28 
vary online 

command syntax UT-29 
device test utility, $IOTEST UT-423 
DG subcommand 

syntax UT-22 
diagnostic utilities 

SDEBUG UT-126 
$DUMP UT-228 
$IOTEST UT-423 
$LOG UT-457 
STRAP UT-589 
digital input 

direct output, $DICOMP subcommand UT-149 
external sync, XI $IOTEST command UT-429 
lOTEST commands UT-424 
direct 

SDEBUG output UT-142 
graphics output UT-149 
disk 
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allocate unmapped storage as a disk UT-460 
DISP command ($FONT) UT-297 
initialize 

a DDSK-30 (30-megabyte disk) UT-1 17 

a DDSK-60 (60-megabyte disk) UT-1 17 

a 4962 UT-1 01 

a 4963 UT-1 05 

a 4967 UT-1 09 
message support UT-470 
diskette 

DISP command ($FONT) UT-297 

format UT-94 

initialize 

using $DASDI UT-94 
record sizes UT-466 

rename volume label and owner id UT-419 
stand-alone dump/$TRAP dump/ UT-91 
vary offline 

command syntax UT-28 
vary online 

command syntax UT-29 
DISP subcommand 
syntax UT-23 
display 

character image tables UT-297 

column setting in source data set UT-346 

insert mask UT-350 

job queue status UT-432 

processor composer, $D ICO MP UT-144 

processor interpreter, $DIINTR UT-1 61 

processor utility, $DIUTIL UT-220 

registers UT-1 36 

screen image UT-396 

spool status 

command syntax UT-23 
status of all tasks UT-1 43 
status of job queue processing UT-435, UT-508 
storage 

command syntax UT-1 6 

contents UT-1 36 

registers UT-1 36 
tape return codes UT-538 
4978 and 4980 program function keys UT-475 
draw 

line, $DICOMP subcommand UT-155 
symbol UT-1 49 
dump 

$D operator command 

syntax UT-1 6 
absolute record numbers UT-1 99 
BSC trace records UT-49 
data set 

on printer UT-202 

on terminal UT-203 

using STRAP UT-589 
diskettes to disk 

with $DUMP utility UT-234 
tape records UT-527 



to multiple diskettes UT-597 
to printer 

with$DICOMP UT-147 

with$DISKUT2 UT-202 

with $DUMP utility UT-228, UT-233 

with$TAPEUT1 UT-527 
to terminal 

with$DICOMP UT-147 

with$DISKUT2 UT-203 
trace buffer UT-577 
unmapped storage UT-228 
volume UT-464 
with$DISKUT2 UT-203 
dynamic storage, specifying UT-286 



E 



echo test. Series/ 1-to-Series/1 UT-518 
edit 

contents of data set UT-322 

line commands, $FSEDIT UT-344 

source data set UT-327 

source statements UT-239 
editor subcommands, $EDIT1 /N UT-247 
eject page in log listing UT-442 
ejecting printer page 

command syntax UT-1 6 
enable/disable trace for channel attach UT-62 
end 

$EDXLINK UT-291 

browse/edit mode UT-339, UT-341 

display (graphics) UT-1 54 

job queue processing UT-436 

job, EOJ command ($JOBUTIL) UT-443 

nested procedure, EOP command ($JOBUTIL) UT-443 
END control statement ($EDXLINK) UT-279 
end-of-data pointer/flag 

reset UT-1 96, UT-201 

set UT-1 96 
enter 

source statements UT-239 

unprotected output fields using $IMAGE UT-401 
error codes 

See return codes 
error handling 

I/O error logging UT-457 
ERRORS command ($EDXLIST) UT-272 
errors option ($EDXASM) UT-266 
EX command ($TAPEUT1) UT-528 
exerciser, BSC line ($BSCUT2) UT-51 
exercising tape UT-528 
EXIO device support 

trace facility UT-576 
external sync DI/DO, XI /XO, $IOTEST command UT-424 
EXTRN statement 

unresolved references UT-295 
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find 

specific text string UT-340 
fornnat 

BSC trace files UT-48 

disk or diskette ($DASDI) UT-90 

formatted screen images UT-386 

messages UT-470 

viewing area into a plotter UT-157 
free space, determining UT-195 
free storage UT-499 
FSF (forward space file) UT-536 
FSR (forward space record) UT-536 
full-screen text editor ($FSEDIT) UT-31 2 



General Purpose Interface Bus 
change partition UT-353 
define 

device UT-354 

end character UT-353 
description UT-352 
displaying commands UT-352 
end utility UT-354 
example UT-360 
GPIB control UT-354 
invoking UT-352 
list device control block UT-355 
post GPIB operation complete UT-360 
read 

data UT-357 

error status UT-358 
reset GPIB adapter UT-358 
resume $GPIBUT1 operation UT-360 
suspend $GPIBUT1 UT-359 
write data to the GPIB adapter UT-359 
get character image table from device UT-301 
GPIB 

See General Purpose Interface Bus 
GPIB control UT-354 

graphic display, method for producing UT-147 
graphics 
utilities 

$DICOMP UT-144 

$DIINTR UT-161 

$DIUTIL UT-220 



syntax UT-23 
horizontal tabs, define with $IMAGE UT-394 
Host Communications Facility 

return codes UT-370 

utility program ($HCFUT1) UT-366 



I 



I/O (input/output) 

exerciser ($BSCUT2) UT-51 

tracing for channel attach UT-61 
I/O error logging 

data set list utility, $DISKUT2 UT-198 

invoking UT-457 

log data set UT-457 

utility, $LOG UT-457 
identify 

batch job stream 

continuation point UT-446 
data set UT-441 

defective RBAs UT-111 

defective RBAs by cylinder UT-1 12, UT-120 

overlay segment UT-282 
image attributes 

blinking UT-388 

change UT-391 

define UT-391 

high intensity UT-388 

low intensity UT-388 

nondisplay UT-388 
image dimensions, define UT-392 
image store 

loading UT-568 

saving UT-572 
image, formatted screen 

See also $1 MAGE utility 

create UT-386 

display UT-389 
INCLUDE control statement ($EDXLINK) UT-279 
initial program load 

See I PL (initial program load) 
initialize 

disk 

$INITDSK utility UT-407 
30-megabyte (DDSK-30) UT-117 

4962 UT-1 01 

4963 UT-1 05 
4967 UT-1 09 

60-megabyte (DDSK-60) UT-117 
I PL text UT-412 



H 



HCF 



See Host Communications Facility 
hold 

batch job UT-506 

spool jobs 

command syntax UT-23 
HOLD subcommand 
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job queue data set UT-434 

MEMDSK UT-460 

partitioned data base UT-224 

Seriesl-to-Series/1 UT-519 

stand-alone dump/ UT-91 

tapes UT-531 

tapes automatically UT-543 

unmapped storage as a disk UT-460 

volumes UT-413 
insert 

blocks of text UT-349 

elements in graphics member UT-146 

line of text UT-348 

member (graphics) UT-154 

new line in source data set UT-348 
interactive debugging UT-126 
intercept class interrupts UT-589 
interface 

$L interactive ($EDXLINK) UT-288 

$L noninteractive ($EDXLINK) UT-288 
invoke 

your operator command ($U) UT-28 
I PL (initial program load) 

initialize text UT-412 



job control statement UT-444 
job printing, spool 

$S ALT syntax UT-20 
job queue 

data set, initialize UT-434 

delete UT-433 

priorities UT-506 

processing status UT-435 

status of job UT-430 
job queue processor 

displaying job status UT-506 
jump 

to address (graphics) UT-154 

to batch job stream label UT-445 

to reference (graphics) UT-155 



K 



KEEP subcommand 

syntax UT-24 
keeping spool jobs 

command syntax UT-24 
kept spool jobs, releasing 

command syntax UT-24 
key 

See program function (PF) keys 
keyboard define utility UT-557 



labels, tape 

See tape 
line editing, $EDIT1 /N UT-264 
LINK control statement ($EDXLINK) UT-280 
link map ($EDXLINK) UT-292 
linkage editor 

See $EDXLINK utility 
linkage editor overlays 

See $EDXLINK utility 
list 

all members with $DISKUT1 UT-184 

breakpoints and trace ranges UT-132 

characters (graphics) UT-155 

configuration UT-428 

data base status (graphics) UT-227 

data members in CTS mode UT-177 

data set 

on printer UT-208 
on terminal UT-210 
with$DISKUT2 UT-210 
with$EDIT1/N UT-255 
with$FSEDIT UT-332 

data set directory 

one data set UT-192 

date/time (graphics) UT-159 

device control block (GPIB) UT-355 

devices on a system UT-427 

directory entries UT-314, UT-319 

error specification UT-266 

graphics member UT-147 

hardware configuration UT-424 

header of data member UT-225 

insert mask UT-350 

processor program, $EDXLIST UT-271 

program function key codes UT-475 

program function keys UT-394 

program members UT-177 

segmentation registers UT-498 

status of all tasks UT-143 

supervisor configuration UT-428 

tape drives and attributes UT-535 

terminal name/type/address UT-552 

unmapped storage information UT-501 

user-assigned sectors UT-115, UT-124 

variables UT-159 

volumes on disk or diskette UT-414, UT-416 
LIST command 

$EDXASM UT-266 

$EDXLIST UT-272 
list directory 

data-type data sets in CTS/RBA mode UT-185 

log data set 

on printer UT-216 
on terminal UT-207 

program-type data sets in CTS/RBA mode UT-192 
load 

control store UT-567 

image store UT-568 
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image store into device UT-302 

program 

$L syntax UT-17 

EXEC $JOBUTIL command UT-444 

session manager UT-32 
load-time storage allocation, modify UT-219 
locate 

line number in the work data set UT-341 
log data set 

for I/O errors UT-457 

list on printer UT-216 

list on terminal UT-207 
logoff menu, session manager 

defined UT-32 
logon menu, session manager 

defined UT-32 



to bottom UT-247 

to top UT-262 

up UT-262 
partitioned data base to another volume UT-226 
tape UT-536 
text 

$EDIT1/N subcommand UT-256 
volumes on disk or diskette UT-465 



N 



name directory sort UT-324 
NOLIST command ($EDXASM) UT-266 
nonautomatic initialization mode UT-545 
NULL character, define UT-395 



M 



O 






magnetic tape 
See tape 
menus, session manager 
custom defined UT-36 
logon /logoff 

defined UT-32 
parameter input 

defined UT-35 
primary option 

defined UT-33 
example UT-34 
secondary option 
defined UT-34 
example UT-34 
merge source and work data set UT-332 
message logging, set off UT-448 
message-sending utility, $TERMUT3 UT-573 
messages, program 

convert to disk- resident format UT-471 
convert to storage-resident format UT-474 
on message volume UT-471 
modify 

an existing source data set UT-329 
character image screen UT-299 
character string 

with$EDIT1/N UT-248 
with$FSEDIT UT-337 
default storage allocation UT-219 
image/control store UT-557 
load-time storage allocation UT-219 
multiple copy commands, $C0PYUT1 UT-82 
storage or registers UT-139 
monitor 

cross partition stack UT-499 
interrupt buffer UT-499 
save or restore process UT-539 
move 

block(s) of text UT-351 
line pointer 

down UT-251 



object data set for $EDXASM UT-265 
operator commands 

$A - list partitions and programs 

syntax UT-13 
$B - blank display screen 

syntax UT-14 
$C - cancel program 

syntax UT-15 
$CP - change display terminal partition 

syntax UT-15 
$D - dump storage 

syntax UT-16 
$E - eject printer page 

syntax UT-16 
$L - load program or utility 

syntax UT-17 
$P - patch storage 

syntax UT-18 
$S - control printer spooling 

ALT UT-20 

DALL UT-21 

DE UT-22 

DG UT-22 

DISP UT-23 

HOLD UT-23 

KEEP UT-24 

PEL UT-24 

STOP UT-25 

WRES UT-25 

WSTP UT-26 

WSTR UT-27 
$T - set date, time 

syntax UT-27 
$U - user operator command UT-28 

command syntax UT-28 
$VARYOFF - set device offline 

syntax UT-28 
$VARYON - set device online 

syntax UT-29 
$W - display date, time 
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syntax UT-30 
entering UT-12 
invoking UT-28 
operator termination ($EDXLINK) UT-291 
option selection menus, session manager 

defined UT-32 
overlay 
area 

defining UT-281 
overlay segment 

identify UT-282 
in unmapped storage UT-283 
OVERLAY control statement ($EDXLINK) UT-282 
OVERLAY option ($EDXASM) UT-267 
OVLAREA control statement {$EDXLINK) UT-281 
owner id on volume, rename UT-419 



page eject, printer 

$E syntax UT-16 
page formatting parameters UT-548 
parameter input menu 

defined UT-35 

example UT-35 
partition 

changing UT-15 

changing assignment 

CP command ($GPIBUT1) UT-353 

listing 

$A syntax UT-13 
partitioned data base 

allocate UT-221 

compress UT-223 

copy member UT-223 

delete a member UT-224 

display directory UT-225 

display member header UT-225 

initialize UT-224 

list status UT-227 

move UT-226 

rename member UT-227 
passing parameters 

using $JOBUTIL UT-449 
patch 

absolute record numbers UT-199 

data set/program UT-200, UT-211 

storage or registers UT- 1 39 
PI 

See process interrupt 
place $SUBMIT utility in suspended mode UT-505 
portion of data set, list UT-208 
post 

event UT-141 

GPIB operation UT-360 

process interrupt UT-141 
post codes 

See completion codes and return codes 
primary commands, $FSEDIT UT-334 



primary option menu, session manager 

defined UT-33 

example UT-34 
primary-control-statement data set UT-275 
print 

BSC trace files UT-48 

contents of work data set UT-342 

graphics member UT-147 

messages UT-473 

trace buffer for channel attach device UT-62 

trace file on printer/terminal UT-48 
print utilities, remote job entry UT-481 
printer spooling 

See spooling 
printers 

ejecting pages ($E) UT-16 
process interrupt 

lOTEST command UT-424 
produce a graphic display UT-147 
program 

cancelling 

$C syntax UT-15 

dump 

on printer UT-202 
on terminal UT-203 

listing active 

$A syntax UT-13 

load 

$L syntax UT-17 

patch UT-211 

in decimal UT-212 
in EBCDIC UT-213 
in hexadecimal UT-213 
with overlay segments UT-214 
program function (PF) keys UT-38 

list 4978 and 4980, $PFMAP utility UT-475 

list, KEYS $IMAGE command UT-394 

when using $FSEDIT UT-317 

when using $1 MAGE UT-394 
program identifier, $JOBUTIL command UT-452 
program libi-ary update 

See$UPDATE utility 
program preparation 

$EDXASM UT-265 

$S1ASM UT-509 
program storage parameter, set UT-219 
prompt- reply format, operator commands UT- 1 2 
protected field 

defined UT-387 









R 



read 



records from host ($HCFUT1 ) UT-367 
analog input UT-425 
data set UT-304 
data set into work file 

with$EDIT1/N UT-242 

with$FSEDIT UT-331 
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with$UPDATE UT-600 

data using $GPIBUT1 UT-357 

digital input using external sync UT-429 

program with $UPDATE UT-600 
realtime data member 

RT$DICOMP subcommand UT-159 
reclaim unused space in partitioned data base UT-223 
record 

format, EDX UT-315 

sizes, diskettes UT-466 
records 

verify UT-421 
redirect spool jobs 

command syntax UT-20 
reformatting diskettes UT-90 
refresh data on 4967 disk UT-113, UT-120 
registers 

contents UT-139 
modify UT-139 
REL subcommand 

syntax UT-24 
release 

a held job UT-506 

nonprogram storage UT-497 

spool jobs 

$S KEEP syntax UT-24 
$S REL syntax UT-24 
release status record ($HCFUT1) UT-368 
Remote Manager 

error logging ($LOG) UT-458 

list log by wrap count and relative record 
on a printer UT-218 
on a terminal UT-209 
remove 

alternate sector assignment UT- 1 1 5, UT- 1 23 

breakpoints and trace ranges UT-138 
rename 

an H-exchange volume UT-378 

data set UT-177, UT-196 

new program with data set allocation UT-601 

terminal UT-555 

volume UT-419 

with$DISKUT1 UT-177 

with$DIUTIL UT-227 
renumber lines within work data set UT-342 
repeat communication line trace UT-579 
replace old program with new program UT-601 
request 

compilation UT-266 
reset 

$EDXLINK linkage editor UT-282 

$LOADER to load from disk UT-462 

control statement {$EDXLINK) UT-282 

device. Series /I -to- Series /I UT-520 

end-of-data pointer UT-201 

GPIB adapter UT-358 

line commands, $FSEDIT UT-343 

option ($EDXASM) UT-267 

system default volume UT-462 
restart 



printer spooling UT-489 
restore 

character set, RE $TERMUT2 UT-570 

data set UT-539 

disk device UT-539 

disk or volume 

from tape UT-539 

diskette, $C0PYUT1 UT-80 

diskette, $MOVEVOL UT-465 

monitor process UT-539 

multiple tapes UT-542 

volume UT-464, UT-539 

4974 to standard character set UT-570 
resume job queue processing UT-434 
retrieve 

host data set UT-242 

Series /I data set UT-243 

source data set UT-331 
return codes 

See also completion codes and post codes 

Host Communications Facility UT-370 
REW (rewind tape) UT-536 
rewind tape UT-536 
roll screen mode for multiple copying UT-82 



sample session UT-482 
save 

contents of 

storage and registers UT-589 
work data set UT-344 

control store UT-571 

data set UT-539 

disk device UT-539 

disk or diskette volume on tape UT-542 

formatted screen UT-397 

graphics data UT-159 

image data set UT-305 

image store UT-572 

monitor process UT-539 

using multiple tapes UT-546 

volume UT-539 
screen format builder utility 

See $1 MAGE utility 
scrolling, $FSEDIT UT-316 
search and dump tape UT-527 
secondary option menu 

defined UT-34 

examples UT-34 
secondary-control-statement data set UT-275, UT-286 
sector size for diskette initialization $DASDI utility UT-95 
segmentation registers 

list UT-498 
send 

data, HX$DICOMP subcommand UT-154 

message to another terminal UT-573 
session manager 

$SMMAIN UT-32 
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$SMMLOG UT-33 

$SMMPRIM UT-34 

alternate session menu 
defined UT-33 

background option UT-36 

custom menus defined UT-36 

introduction UT-31 

loading UT-32 

logon menu 

defined UT-32 

parameter input menu 
defined UT-35 
example UT-35 

primary option menu 
defined UT-33 
example UT-34 

program function keys UT-38 

secondary option menu 
defined UT-34 
example UT-34 

user ID defined UT-32 

utilities supported UT-39 
set 

$LOADER to load from MEMDSK UT-463 

breakpoints and trace ranges UT-130 

COBOL line numbers in edit mode UT-339 

data set contents to zero UT-201 

default volume for linkage editor UT-284 

program storage parameter UT-219 

status ($HCFUT1) UT-368 

system default volume to MEMDSK UT-462 

tabs UT-259 

tabs in edit work data set UT-343 

tape offline UT-536 

uppercase conversion UT-335 

3101 display terminal switch settings UT-31 8 
set tabs 

horizontal ($IMAGE) UT-394 

vertical ($IMAGE) UT-399 

with$EDIT1/N UT-259 
setup procedure for $JOBUTIL UT-437 
single-line format, operator commands UT-12 
sort 

alphabetically UT-169 

by ascending data set size UT-172 

by descending data set size UT-173 

by location UT- 1 70 

in predefined order UT-174 

interactively UT-176 
source messages, format UT-470 
special PI bit/group UT-429 
specify 

dynamic storage ($EDXLINK) UT-286 
split a volume UT-420 
spool data set 

designating UT-489 
spooling 

ALT subcommand UT-20 

alter job printing 

command syntax UT-20 



automatic writer start UT-492 
capacity parameters 

changing UT-489 

defaults UT-491 
cold starting UT-490 
DALL subcommand UT-21 
DE subcommand UT-22 
delete a job 

command syntax UT-22 
delete all jobs 

command syntax UT-21 
delete generic jobs 

command syntax UT-22 
DG subcommand UT-22 
DISP subcommand UT-23 
display status 

command syntax UT-23 
ending 

command syntax UT-25 
forms, altering ($S ALT) UT-20 
hold jobs 

command syntax UT-23 
HOLD subcommand UT-23 
keep jobs 

command syntax UT-24 
KEEP subcommand UT-24 
operator functions 

change max spool jobs UT-492 

change spool data set UT-492 

change spool devices UT-492 
REL subcommand UT-24 
releasing kept jobs 

command syntax UT-24 
restart writer 

command syntax UT-25 
restarting UT-489 
start a writer 

command syntax UT-27 
stop a writer 

command syntax UT-26 
stop spooling 

command syntax UT-25 
STOP subcommand UT-25 
WRES subcommand UT-25 
writer 

changing UT-20 

4- — I.: — I IT oc 
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Starting UT-27 
status UT-23 
stopping UT-26 
WSTP subcommand UT-26 
WSTR subcommand UT-27 
stand-alone dump 

create diskette UT-91 
start 

channel attach device UT-62 
job queue processing UT-503 
programs 

$L syntax UT-17 
status commands ($HCFUT1) UT-368 
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status display, WHERE $DEBUG UT-143 
status-obtaining error 

with $GPIBUT1 UT-358 

with$S1S1UT1 UT-520 
stop 

batch logging UT-432 

channel attach device UT-62 

multiple copies UT-83 

spool writer UT-26 
STOP subcommand 

syntax UT-25 
storage 

displaying 

command syntax UT-16 

dumping UT-589 

patching 

command syntax UT-18 

release nonprogram UT-497, UT-499 
submit 

and hold a batch job UT-506 

job 

for execution UT-506 
tohost($HCFUT1) UT-368 
to host job stream UT-332 
to job queue processor UT-503 
surface analyzing tape UT-528 
suspend 

$GPIBUT1 UT-359 

$JOBQUT utility UT-433 

job queue processing UT-434 
system 

AUTOCALL data set ($EDXLINK) UT-294 



tab 



set in edit work data set UT-343 



tape 

control commands UT-536 

data set, allocate UT-547 

label, change UT-531 

management UT-522 

return codes, display UT-538 

vary offline UT-28 

vary online UT-29 
tape drive 

change attributes UT-526 

list defined tape drives UT-535 
terminal 

configuration utility, $TERMUT1 UT-548 

message-sending utility, $TERMUT3 UT-573 
terminating GPIB operation UT-352 
test 

BSC conversational transparent mode UT-56 

BSC definitions UT-51 



display ($DICOMP) UT-147 

generated report or graphics profile member UT-147 

label types UT-528 

process interrupt UT-429 
text editing utilities 

full-screen editor UT-312 

line editors UT-235 
time and date 

display 

command syntax UT-30 

set 

command syntax UT-27 
trace 

ACCA activities UT-576 

BSC activities UT-46 

buffer for channel attach device, print UT-62 

buffer, dump UT-577 

communications activities, repeat UT-579 

data set, display UT-577 

EXIO activities UT-576 

printing utility for BSC UT-48 

range and breakpoint, remove UT-138 

ranges and breakpoint settings UT-130 

record format for BSC line UT-47 

utility for BSC UT-46 
transfer 

data set across a bisync line ($TRANS) UT-581 

data set from host ($HCFUT1) UT-367 

data set to host 

WR command ($HCFUT1) UT-369 
WRITE $EDIT1 command UT-245 
WRITE $FSEDIT UT-331 
transmit data sets across a bisync line 

$TRANS UT-581 

data management support 
$DASDI UT-90 
$DISKUT1 UT-177 



u 



UNMAPCNT control statement ($EDXLINK UT-283 
unmapped storage 

allocate as a disk UT-460 

dump UT-228 

list UT-136 

modify 

allocation UT-219 
locations UT-139 

patch UT-139 

trap UT-589 
unprotected field 

defined UT-387 

output fields UT-401 
unresolved external references (EXTRNs) UT-295 
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C 



vary 

device offline 

command syntax UT-28 
device online 

command syntax UT-29 
tape online automatically UT-540 
terminal offline UT-553 
terminal online UT-554 
verify 

BSC communications UT-51 
disk or diskette data set UT-421 
tape is executing correctly UT-528 
4967 disk UT-111 
vertical tabs, define UT-399 
volume 

allocating UT-404 

change UT-181, UT-201 

change for directory sort UT- 1 70 

compressing UT-70 

copying UT-72, UT-76 

deleting UT-406 

disk backup UT-84 

dump/restore, $MOVEVOL UT-465 

free space UT-195 

initialize UT-407, UT-413 

initialize H-exchange UT-376 

IPL volume, copy UT-84 

list 

all UT-188 

disk or diskette UT-414, UT-416 

list all data sets UT-172 
list directory entries UT-319 
number of 

data sets UT-195 

directory entries UT- 1 95 

free space entries UT-195 

unused directory entries UT-195 

unused records UT-195 
rename UT-419 

rename label and owner id UT-419 
size UT-195 
sort 

alphabetically UT-169 

by ascending data set size UT-172 

by descending data set size UT-1 73 

by location UT-1 70 

description UT-1 68 

in predefined order UT-1 74 

interactively UT-1 76 
split UT-420 

update H-exchange volume label UT-383 
verify UT-421 
with$FSEDIT UT-324 
VOLUME control statement ($EDXLINK) UT-284 
volume label, rename UT-419 



wait state 

put program in wait state UT-424 
weak external reference (WXTRN) UT-295 
work data set 

$EDXASM UT-265, UT-272 

$EDXLINK UT-275 

$S1ASM UT-509 

save UT-344 
WRES subcommand 

syntax UT-25 
write 

data 

Series/ 1-to-Series/1 UT-521 
to the GPIB adapter UT-359 

digital output using external sync UT-429 

IPL text UT-412 

one sector ID UT-1 16 

source data set to a host/native data set UT-331 
write verify 

clear UT-422 

set UT-422 
writer, spooling 

See spooling 
WSTP subcommand 

syntax UT-26 
WSTR subcommand 

syntax UT-27 



30- megabyte disk (DDSK-30) 
data management support 
$DASDI UT-90 
$DISKUT1 UT-1 77 
initialize UT-1 17 
3101 Display Terminal 

screen format UT-388 



4971 printer 

data manaaement support 
4975-01 A ASCII printer 

data management support 
$TERMUT1 UT-550 
4978 display station 

change hard-copy device ($TERMUT1) UT-556 

data management support 
$FONT UT-296 
$TERMUT2 UT-557 

data set sizes UT-558 

keyboard UT-563 

scan code UT-561 

screen format UT-387 
4980 display station 
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change hard-copy device ($TERMUT1) UT-556 
data management support 

$FONT UT-296 

$TERMUT2 UT-557 
data set sizes UT-559 
keyboard UT-563 

load terminal command (LT) UT-569 
scan code UT-561 
screen format UT-386 



60-megabyte disk (DDSK-60) 
initialize UT-117 



5219 printer 

data management support 
$TERMUT1 UT-551 
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